scalecomponents is only used on the ASRSvehicle (and maybe the Crane). They just implement these as nodefunctions to call when they want to resize the sub-components of the object when the user is dragging on sizers. The engine has no special meaning for "scalecomponents." It's just a nodefunction that the ASRS decided to put in eventfunctions.
setpickingdrawfocus() allows you to define what "pick type" subsequent draw commands will be applied to. When the user clicks/mouse-moves/hovers in the 3D/2D/tree view, the engine does an unrendered drawing pass to find out what is being clicked/moved/hovered. Use getpickingmode() in your draw trigger to figure out if the drawing pass is one of these "pick" passes. Then use setpickingdrawfocus() to define what you want subsequent draw commands to be associated with. You can do this, first off, to "dupe" the engine into selecting a different object than the one doing the drawing, or, more useful in my opinion, to define special "pick types" for certain drawn parts. You can use standard pick types like PICK_SIZERX, which would cause the subsequent drawn polygons to behave like the user is clicking on the red x-sizer, i.e. if the user clicks on that part and drags to the right, the x size of the object will increase. Or you can define your own pick types, and then in the object's OnClick() or OnMouseMove() or OnDrag(), use getpickingdrawfocus() to get information on what "focus" was picked, and then do different things based on that. The obvious application for this to me is implementing different drawn "handles" on a conveyor, where you can add sections, resize sections, rotate sections, etc. all from within the 3D view.
For setpickingdrawfocus()'s parameters, focus is the object that will be selected if you click/hover/etc., "what" is the pick type. For this parameter, it would usually either be 0 (meaning just the object itself), PICK_SIZERX, PICK_SIZERXNEG, PICK_SIZERY, ... or your own defined pick type (any positive number because negative numbers are the reserved types). Secondary focus is just an extra storage identifier so you can store an alternate object reference if needed and then get it with getpickingdrawfocus(). detectdrag defines how you want the engine to detect dragging operations with this item picked, i.e. should it only detect dragging along the object's z-axis, along the xy plane, etc. Then you get that information out in the OnDrag() with the draginfo() command.
drawobjectpart() is not part of the commandlist, so it's technically not "supported" yet, but it basically taps into the engine's standard mechanism for drawing object parts like sizers, red highlights, yellow highlights, etc.
If you're going to use getpickingdrawfocus(), make sure you're updated to 5.0.4. We slipped in the "pickedid" parameter so you need to include that parameter to be forward-compatible.
|
