vrmlpad21.docx

1、vrmlpad21VrmlPad v. 2.1Users GuideCopyright 1999-2004 ParallelGraphicsContentsOverview 1About VrmlPad 1Product Features 1New Features in VrmlPad 2.1 2New Features in VrmlPad 2.0 3Available Add-ins 4Material Editor 4Find in Files 4Fields validation macro 4Sample macros 5Extrusion Editor 5About VRML 6

2、Design Criteria 6Characteristics of VRML 6Scope 6Introduction to the VrmlPad Automation 7Text Editor 9Overview: Text Editor 9Syntax Coloring 9AutoComplete 10Error Processing 11Node Folding 12Node thumbnails 13Finding Text 14Regular Expressions 15File Navigation 16Working with Workspace 17Using Drag-

3、and-Drop Editing 18Editor Commands and Keystrokes 18Scene Tree 21Overview: Scene Tree 21Scene Tree Navigation 22Moving, Copying, and Cloning Nodes within the Scene Tree 22Naming Nodes in the Scene Tree 23Routing Map 25Overview: Routing Map 25Managing Routes 25Resource View 27Overview: Resource View

4、27Managing Resources 27Using Drag-and-Drop in the Resource View 28File List 30Overview: File List 30Using Drag-and-Drop in the File List 30Script Debugger 32Overview: Script Debugger 32Edit Time, Run Time, and Break Mode 32Debugger commands 34Debugger windows 36Spreadsheet Fields 37Viewing the Value

5、 of a Variable 37Modifying the Value of a Variable 38Publishing Wizard 40The Basics of Publishing 40Setting Up the Destination 40Choosing Additional Resource Directories 40Excluding Files from Publishing 41VRML Optimization Options 41Specifying Directory Organization 42Reviewing the Directory Struct

6、ure 42Previewing Published Documents 42Hints and Tips 43How to compress a VRML file 43How to download a VRML file from the Net. 43How to upload a VRML file to a remote server. 44How to quickly find the definition (reference) of an identifier. 44How to insert a pair of node or PROTO braces. 45How to

7、insert default field value. 45How to indent a block of lines. 45How to comment a block of lines or an entire node. 45How to locate a syntax or semantic error. 46How to make a VRML file smaller. 46How to expose a field to a PROTO interface. 46How to register a VRML extension. 47How to change a set of

8、 the standard nodes. 47How to change a source of the Node Help. 48What are the ways I can access the VrmlPad object model? 48How to automate VrmlPad from another application. 49OverviewAbout VrmlPadVrmlPad is a powerful and flexible authoring tool from ParallelGraphics that allows you to design and

9、develop professional VRML content.Use VrmlPad to create VRML worlds for publishing on the World Wide Web. VrmlPad fully supports the VRML 97 specification.Product Features Editing Access to local and remote files, multiple undo/redo, set bookmarks, advanced find and replace, syntax tips, smart AutoC

10、omplete, autoindent, dynamic node folding, customizable keyboard shortcuts. Enhanced color-coding Customizable by VRML keywords, field and node categories. Dynamic errors detecting View and enumerate syntax and wide range of semantic errors and warnings undefined identifiers, nonmatched fields, dupl

11、icated node definitions and more. Document Tabs Open and edit multiple documents. Find and replace in all opened documents. Document list includes also file dependencies of the active document. Scene Tree View, edit and navigate hierarchical scene structure. Synchronize selection in both directions.

12、 Delete, comment and rename nodes, PROTOs and field declarations. Routing Map View and edit scene routes. Synchronize selection in both directions. Delete, comment and add new routes using Start Route and Add Route commands. Resource View View, edit and navigate document dependencies. Rename and bro

13、wse all references to a resource. Convert, when possible, absolute references to relative and vice versa. Preview Preview scenes in installed browsers and VRML viewers. Preview individual nodes using the Node Preview command. Publishing Wizard (not shown on the figure) Organize and optimize your sce

14、ne with dependencies for publishing on the Net and put the files on your Web server or send it by e-mail. Automation and Scripting (not shown on the figure) Manipulate the program from external applications using the C, C+, Visual Basic, Borland Delphi. Create add-ins, VBScript and JavaScript macros

15、 and execute them from within the VrmlPad environment, automating custom tasks. VrmlScript Debugger Locate bugs in your vrmlscript driven interactive VRML scenes using the integrated script debugger.The debugger interface provides wrapper for the Cortona VRML client, special menus, windows, dialog b

16、oxes, and spreadsheet fields. Drag-and-drop functionality is available for moving debug information between components. Occasionally the debugger is paused in break mode, meaning the debugger is waiting for user input after completing a debugging command (like break at breakpoint, step into/over/out

17、/to cursor, break after Break command or Restart). Node Thumbnails - Preview individual nodes in the scene at the right of Text editor as soon you type. Preview selected nodes in a default VRML-viewer.New Features in VrmlPad 2.1Preview individual nodesIn addition to previewing a whole scene, now you

18、 can preview any individual node in it. This node (as well as its descendant nodes, if any) will be opened in a default VRML-viewer. To preview a node, position the caret inside the text of the node and choose Node Preview command from Tools menu.Node thumbnailsNode thumbnails are small rendered pic

19、tures of individual nodes in the scene. These pictures appear to the right of the Text editor as soon you type in the text of the corresponding nodes.To enable node thumbnails, choose Options from Tools menu, click Editor tab to open the corresponding page, and select Render node thumbnails.Working

20、with workspaceNow you can save the current VrmlPad workspace, including the placement of all open files, their caret positions, bookmarks, fold settings and debug breakpoints. Choose File Workspace Save and specify the name for the workspace to be saved. The latest saved workspace will be opened aut

21、omatically when you restart VrmlPad. To use a different workspace, choose it in the Open Workspace dialog (File Workspace Open), workspace files have the .vws extension.New Features in VrmlPad 2.0Integrated Script DebuggerNow you can use debugging features that are collectively referred to as integr

22、ated script debugger. These features let you find and fix errors in the inline vrmlscript code in your VRML scenes and on HTML pages with embedded Cortona controls. The integrated script debugger is a full-featured debugger that enables you to: Control the execution of your script, including pausing

23、 the execution; running to a cursor, or a breakpoint location; stepping through code. Monitor the state of script data, including the current call stack; variables, arrays, and objects that are available in the current context; evaluate expressions, containing these data items. Modify the values of

24、variables, arrays, and objects in your script during a debugging session. Add new procedures to your script during a debugging session as you would in code. Examine and modify on the fly data items in the script using the Quick watch window. Use CodeTips for quick viewing of variables values in the

25、script. Examine full VRML text of runtime nodes corresponds to value of an expression.Fields validation macroThe macro validates conformance of field values to the VRML97 specification. Some of about 100 checks performed by the macro: verifies node fields contain correct type of node or PROTO; incre

26、asing interpolators key values, ratio of key to keyValue entries; correct relationship between coord/coordIndex, texCoord/texCoordIndex, color/colorIndex, normal/normalIndex; Color values being in range 0 to 1 and more.Search In Files add-inThe Find in Files window enables you to perform advanced te

27、xt search in multiple VRML files a time (including compressed files). Literal text strings or regular expressions to find words or characters can be used in this command.Available Add-insMaterial EditorThe Material Editor lets you create and edit Appearance and Material nodes. You also can choose ex

28、isting materials from a pre-built library and add your own materials to it.Find in FilesThe Find in Files add in enables you to perform advanced text search in multiple VRML files a time (including compressed files). Literal text strings or regular expressions to find words or characters can be used

29、 in this command.To find a text string in multiple source files:1. From the Tools menu, choose Find in Files.2. In the Find what box, type the search text or a regular expression.3. In the In folder box, select the folder that you want to search.4. If necessary, select one or more of the Find option

30、s.5. Click the Find button to begin the search.6. To open a file containing a match, double-click the entry in the list below.Fields validation macroThe Fields Validation macro checks scenes for conformance of various field values to the VRML97 specification. Among of about 100 tests performed by th

31、e macro are checks for: the field type compatibility (fields should contain nodes or PROTOs of correct type); increasing interpolators key values; ratio of key to keyValue entries; relationship between coord/coordIndex, texCoord/texCoordIndex, color/colorIndex, normal/normalIndex values; Color value

32、s being in range 0 to 1; etc.To validate fields: From the Tools menu, choose Validate Fields.Sample macrosSample macros include useful commands for enumerating faces in IndexedFaceSet nodes, completing selected nodes with all fields, and converting the Box, Cone and Cylinder nodes to an IndexedFaceSet etc.Macro De