@mxw/seminar-importer v1.7.0

seminar-importer

A command line tool to create spaces for MAXWHERE Seminar from appropriate .scene descriptros and Ogre3D assets.

install

$ npm i @mxw/seminar-importer -g

use

  Usage: cmd [options] <input>

  Options:

    -h, --help                   output usage information
    -V, --version                output the version number
    -f, --folder <folder name>   folder of the Where to be created (string)
    -w, --where <where name>     deployable neme of the Where (string)
    -c, --creator <creator>      creator of the .scene file (Valid oprions are max or blender)
    -W, --webtable_reori         Enable correction of webtable orientation (optional)
    -p, --physic_mesh_generation Mode of the physical mesh genration (optional)
    -l, --add_default_lighting   Enable add default lighting to index.jsx (optional)

  Examples:

    $ seminar-importer whereFromBlender.scene -w myCoolWhere -f myCoolFolder -c blender -l
    $ seminar-importer whereFromMax.scene -w myCoolWhere -f myCoolFolder -c max -l
  
    Collision shapes are created from the obj files named [meshname]_smpl.obj
    located within the folder of the processed .scene file.
  
    -l Adds default lighting to the scene.
  
    In seminar, you can visualize physical shapes using the key F8.
  
    Automatic physical shape generation:
    $ seminar-importer whereFromBlender.scene -w myCoolWhere -f myCoolFolder -c blender -p meshDecimationHigh
    $ seminar-importer whereFromMax.scene -w myCoolWhere -f myCoolFolder -c max -p meshDecimationHigh
  
    `-p <mode>` possible values = meshDecimationHigh, meshDecimationLow, cvxhull, cvxdecomp
  
    +======================+==============================+
    |      -p <mode>       | Original mesprocessor option |
    +======================+==============================+
    | meshDecimationHigh   | -meshDecimation 10 10 0.01   |
    +----------------------+------------------------------+
    | meshDecimationMedium | -meshDecimation 10 10 0.1    |
    +----------------------+------------------------------+
    | meshDecimationLow    | -meshDecimation 10 10 0.2    |
    +----------------------+------------------------------+
    | cvxHull              | -cvxhull                     |
    +----------------------+------------------------------+
    | cvxDecomp            | -convexDecomposition 8000 32 |
    +----------------------+------------------------------+
  
    NOTE: Collision shape genration with `-p meshDecimationHigh` is optional and experimental, if you use this
    seminar importer tries to create collision shapes from ogre mesh files. The success rate is about 90% only.
    If seminar-importer find files named [meshname]_smpl.obj the generation for [meshname].mesh is skipped.
    The failure of physical mesh generation is usually caused by a mesh problem. In this case, you get error
    message during the process and you get a list of failed attempts at end of the process and some tipp for repair.
  
    It is highly recommeneded to check all physical shapes in Seminar drawing out physical meshes with the key F8.