SobekCM-plugin-viewer-MODEL3D is a plugin for the open-source SobekCM Digital Repository software (Mark V. Sullivan, lead developer). It provides a viewer for 3D model content using 3DHOP, a HTML5-WebGL viewer created by Marco Potenziani and Marco Callieri.
JavaScript C# HTML CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
plugin-folder-SobekCM/MODEL3D
source
.gitignore
LICENSE
README.md

README.md

SobekCM-plugin-viewer-MODEL3D

SobekCM-plugin-viewer-MODEL3D is a plugin for the open-source SobekCM Digital Repository software (Mark V. Sullivan, lead developer). It provides a viewer for 3D model content (nxs or ply format) based on 3DHOP, a HTML5-WebGL viewer created by Marco Potenziani and Marco Callieri.

Testing the plugin:

  • Complete the standard SobekCM plugin installation steps.
  • Create a new item.
  • Upload a 3D model in the .nxs or .ply format.
  • Upload a config.js, changing defaults if desired.
  • Edit behaviors and add the MODEL3D viewer.

config.js file

The config.js file supports two different approaches to initial scene configuration - rotation & start distance and/or trackball position. You can use one or the other or both in combination. The file contains variables that will be used by the setup3dhopCustom.js file. The myrot values and mystartd values are required, the tbpos value is optional.

  • myrotx - the X value of the initial transformation rotation. Default value is 0.
  • myrotx = the Y value of the initial transformation rotation. Default value is 0.
  • myrotz = the Z value of the initial transformation rotation. Default value is 0.
  • mystartd = the starting distance.
  • tbpos = An array of the trackball position values. To make it easier to obtain this data I added an additional 'function' to the standard interface. An additional icon appears at the bottom of the tool links on the left. Use the trackball (the default is the Sphere trackball) to position the model how you want it to display initially, click the icon, and the current trackball position array will display in a popup. Copy and past this into your config.js file.
  • myskinbackgroundfile = The file name of the skin background image file for the canvas. Optional - if not used the default is skins/dark/light.jpg.
  • mybackgroundcolor = Color value for background of the canvas. Optional - if not used, if the myskinbackgroundfile value exists that will be used, otherwise the default background-image file is used - skins/dark/light.jpg. If both myskinbackgroundfile and mybackgroundcolor exists the mybackgroundcolor is used and the myskinbackgroundfile is ignored.

Credits

Mark V. Sullivan (SobekCM's lead developer, Sobek Digital Hosting & Consulting) - Although I developed this plugin myself I was able to do so because of the excellent traning Mark provided to me in December 2016. I followed the initial design pattern of the SobekCM-plugin-viewer-RTI plugin that we started developing collaboratively during that training session.

SobekCM - the open-source digital repository software of which I am also a contributor. The GitHub repository for SobekCM is a SobekCM/SobekCM-Web-Application. See also the Sobek Home.

Marco Potenziani and Marco Callieri - Created the 3DHOP viewer at the Visual Computing Lab - Istituto di Scienza e Tecnologie dell’Informazione “A. Faedo”(ISTI), an Institute of the National Research Council of Italy (CNR) at Pisa, Italy. See the 3DHOP contacts page. 3DHOP was released under the GNU General Public License version 3.

Marco Di Benedetto and Marco Potenziani (also from the Visual Computing Lab - ISTI - CNR) - 3DHOP depends upon SpiderGL, also available via GitHub. SpiderGL was released under the GNU General Public License version 3.

NEXUS tools - the NEXUS Windows console apps are used to generate multi-resolution nxs content.

3DHOP - using their gargo.nxs sample 3D model content as the default content if a .nxs or .ply file is not available in the SobekCM item content folder. The sample content used is in the 3DHOP/models folder in the 3DHOP official distribution file (currently 4.1) which is linked on the 3DHOP download page.


Richard Bernardy - rbernard@usf.edu - 04/15/2017.

I'd appreciate a courtesy notification by email if you find this plugin useful and are using it in your SobekCM-based respository.