Notations:
Name: name corresponding to the osgdb_NAME plugin
Type: pseudo, image, multimedia (video), font, 3d, network, compression (archive), device.
Dependencies: light grey=standard plugin with dependencies, C++ EXCP=C++ Exceptions required, opt=optional dependencies
Platforms: W= Windows, M= Mac OS X, L= Linux, A= Android, i= iOS
Ext: corresponding to the extension defined with the plugins (and used by osgDB::Registry).
| Name | Type | Dependencies | W | M | L | A | i | Ext. | Description | Notes |
| ——————– | ————— | ——————————– | - | - | - | - | - | ——————————————————————————————————————————————————————————————————————————————————————————————— | ———————————- | ———————————————————————————————————– |
| osga | pseudo | - | Y | Y | Y | Y | Y | .osga | OSG Archive format | |
| rot | pseudo | - | Y | Y | Y | Y | Y | .rot | Rotates to the loaded model | |
| scale | pseudo | - | Y | Y | Y | Y | Y | .scale | Scales the loaded model | |
| trans | pseudo | - | Y | Y | Y | Y | Y | .trans | Translates the loaded model | |
| normals | pseudo | - | Y | Y | Y | Y | Y | .normals | Shows normals of the loaded model | |
| revisions | pseudo | - | Y | Y | Y | Y | Y | .revisions,.added,.removed,.modified | Revisions Font | |
| view (osgviewer) | pseudo | - | Y | Y | Y | Y | Y | .osgviewer, .view | osgViewer Configuration | |
| shadow (osgshadow) | pseudo | - | Y | Y | Y | Y | Y | .osgShadow,.shadow | osgShadow Configuration | |
| terrain (osgterrain) | pseudo | - | Y | Y | Y | Y | Y | .osgTerrain, .terrain | osgTerrain Configuration | |
| osg | native | - | Y | Y | Y | Y | Y | .osg | Native OSG binary format | Write |
| ive | native | - | Y | Y | Y | Y | Y | .ive | Native OSG ascii format | Write |
| cfg | viewer | - | Y | Y | Y | Y | Y | .cfg | Camera configuration info | |
| glsl | shader | - | Y | Y | Y | Y | Y | .gl, .frag, .vert, .geom, .glsl, .tctrl, .teval, .compute | GL Shader file formats | |
| rgb | image | - | Y | Y | Y | Y | Y | .rgb, .rgba,.sgi, .int, .inta, .bw | RGB Image | Write |
| bmp | image | - | Y | Y | Y | Y | Y | .bmp | Windows Bitmap | Write |
| pnm | image | - | Y | Y | Y | Y | Y | .pnm, .ppm, .pgm, .pbm | | Write |
| dds | image | - | Y | Y | Y | Y | Y | .dds | DirectX image format | Write, Read Options: dds_dxt1_rgb,dds_dxt1_rgba , dds_dxt1_detect_rgba, dds_flip |
| tga | image | - | Y | Y | Y | Y | Y | .tga | Targa image | |
| hdr | image | - | Y | Y | Y | Y | Y | .hdr | High Dynamic Range image | Write, Read Options: RGBMUL, RGB8, RAW, YFLIP, NO_YFLIP |
| dot | image | - | Y | Y | Y | Y | Y | .dot | | |
| vtf | image | - | Y | Y | Y | Y | Y | .vtf | Valve Texture Format | |
| ktx | image | - | Y | Y | Y | Y | Y | .ktx | KTX Image format | |
| jpeg | image | jpeg | ? | ? | ? | ? | ? | .jpeg .jpg | JPeg Image | Write |
| jp2 | image | jasper | ? | ? | ? | ? | ? | .jps .jpc | JPEG 2000 | Write |
| exr | image | openexr (opt:zlib), C++ EXCP | ? | ? | ? | ? | ? | .exr | | |
| gif | image | giflib | ? | ? | ? | ? | ? | .gif | GIF Image | |
| png | image | libpng (opt:zlib), C++ EXCP | ? | ? | ? | ? | ? | .png | Portable Network Graphics | Write |
| tiff | image | libtiff (opt:zlib), C++ EXCP | ? | ? | ? | ? | ? | .tiff .tif | Tiff image | Write |
| gdal | image | gdal | ? | ? | ? | ? | ? | .gdal | GDAL image loader | |
| ogr | image | gdal | ? | ? | ? | ? | ? | .ogr | | Read Options: useRandomColorByFeature, addGroupPerFeature |
| gta | image | libgta, C++ EXCP | ? | ? | ? | ? | ? | gta | Generic Tagged Arrays | |
| dicom | image (medical) | dcmtk, zlib (or itk) | ? | ? | ? | ? | ? | .mag, .ph, .ima, .dic, .dcm, .dicom | | |
| attr | image | - | Y | Y | Y | Y | Y | .attr | OpenFlight texture attributes | Build with OpenFlight plugin |
| 3dc | 3d | - | Y | Y | Y | Y | Y | .3dc, .asc | 3DC point cloud format | |
| p3d | 3d | - | Y | Y | Y | Y | Y | .p3d, .xml | Present3D XML | |
| curl | network | curl (opt:zlib,openssl, openssh) | ? | ? | ? | ? | ? | .curl (pseudo file), * (P: http, https, ftp, ftps) | HTTP Protocol Model | Read Options: OSG_CURL_PROXY,OSG_CURL_PROXYPORT,OSG_CURL_CONNECTTIMEOUT,OSG_CURL_TIMEOUT |
| gz | compression | zlib | ? | ? | ? | ? | ? | .osgz,ivez, .gz | | |
| Inventor | 3d | Inventor (non GLES) | ? | ? | ? | N | N | .iv, .wrl | Open Inventor format | Write, .wrl Only VRML1.0 |
| pfb | 3d | OpenGL Performer | ? | N | ? | N | N | SEE BELOW | Performer loader | no GLES |
| vrml | 3d | openvrml, C++ EXCP | ? | ? | ? | ? | ? | .wrl | VRML2 | Read Options: directoryTeture
OSG Plugins (platforms and dependencies)
Remarks, Additional information:
3ds: to be compiled on Android, you need to modify default CMake configuration.
zlib: to be compiled on Android, you need to modify default CMake configuration (existing zlib with Android NDK used by default).
MultiGen Read Options: clampToEdge, keepExternalReferences,preserveFace,preserveObject,replaceDoubleSidedPolys,dofAnimation,billboardCenter,noTextureAlphaForTransparencyBinning,readObjectRecordData,preserveNonOsgAttrsAsUserData,noUnitsConversion,convertToFeet,convertToInches,convertToMeters,convertToKilometres,convertToNauticalMiles
obj Read Options: noRotation, noTesselateLargePolygons,
noTripStripPolygons, generateFacetNormals,
DIFFUSE=
Performer supported format: 3ds, arcinfo, bin, bpoly, bw, byu,closest,csb,ct,dem,doublerot,doublescale,doubletrans,dted,dwb,dxf,evt, flt, gds,gfo, im, irtp, iv20, iv, lodfix,lsa, lsb,medit, m,nff, obj,pegg,pfb, pfs, phd,poly,post,proc, projtex, pts, rot, scale, sgf, sgo, so, spf, spherepatch3, spherepatch, sphere, sponge, star, stla, stlb, substclip,sv,trans,tri,unc,vct.
Quicktime remark: Please note that http://libquicktime.sourceforge.net/ is a totally different library from Apple Quicktime (so no compatibility with Linux).
FBX Remark: Requires Autodesk’s FBX SDK. If using OpenSceneGraph 2.8.x you’ll need version 2010.2 of the SDK. Otherwise check ReaderWriterFBX.h to see which version of the SDK is required (currently 2012.1). If you have problems loading an FBX model please check that it works in Autodesk’s FBX QuickTime Viewer first to see if the model was correctly exported.
OSC Notes: the osc-plugin can return an osgGA::Device which handles various osc-messages and puts them into the event-queue of the app you can set arbitrary values via /osg/set_user_value, these values are set on the attached UserDataConntainer (see below) To open the osc-device for receiving do something like this:
* std::string filename = ".receiver.osc";
* osgGA::Device* device = dynamic_cast<osgGA::Device*>(osgDB::readObjectFile(filename));
and add that device to your viewer The plugin supports the following option: documentRegisteredHandlers, which will dump all registered handlers to the console. The device registers some convenient handlers to remote control a p3d-presentation.
you can feed a osgPresentation::PropertyManager into the plugin and set values on it via “/p3d/set_value key value” or “/p3d/set_value/key value” Additionally the plugin listens for “/osg/set_user_value key value” or “/osg/set_user_value/key value” and set the transmitted value on the UserDataContainer of the device.
The plugin supports forwarding most of the events per osc to another host. It uses a special event-handler, which forwards the events. To get this event-handler, do something like this:
* std::string filename = ":.sender.osc";
* osgGA::GUIEventHandler* event_handler = dynamic_cast<osgGA::GUIEventHandler*>(osgDB::readObjectFile(filename));
and add that event handler as the first event handler to your viewer/app