FePrimitives 0.9.1 Short Documentation

7/24/2019 FePrimitives 0.9.1 Short Documentation

http://slidepdf.com/reader/full/feprimitives-091-short-documentation 1/7

1 Extended Polygonal And NURBS Primitives

This is a collection of extended primitives including NUBRS Curves and polygonal objects.There is a command for creation and a node for construction history support. They or!almost exactly li!e the built"in primitives# except the folloing restrictions$

• the "edit %"e& and 'uery %"'&"flags are not yet supported %in scripts you could useget(ttr)set(ttr on the ma!e"node instead&

• the "object %"o&"flag is not yet supported

• the polygon primitives have no uv"coordinates yet %see *&# therefore the "texture %"tx&"flag and attribute are not implemented

Common Attributes For All Primitives:

description parameters

+efines the local axis the object is aligned to. • axis• axis,• axis- • axis

+efines the location the object is created at. • pivot• pivot,• pivot- • pivot

/f this attribute is true# the object is created sitting onits loer border. /f false it is created centered.

• basedTo0ivot

1ost of the individual (ttributes are 'uite self"explanatory or or! li!e those from thestandard"primitives# li!e radius# height etc. (ll others are described belo$

Polygonal Obe!ts:

Bevel Box

( polygonal cube ithfilleted rims.•

height• idth• depth• subdivisions idth• subdivisions height• subdivisions depth• dimension type• fillet radius• fillet as fraction• subdivisions fillet

Bevel Cylinder



( polygonal cylinder ith filleted rims.

• radius• height• height type• fillet radius• fillet as fraction• subdivisions idth• subdivisions height• subdivisions fillet• subdivisions cap

Bevel Tube

( polygonal pipe ithfilleted rims.

• radius• thic!ness• height• height type• fillet radius• fillet as fraction• subdivisions idth• subdivisions height• subdivisions fillet• subdivisions cap

Capsule

( polygonal cylinder

ith a half"spherical capon each end. The capheight is a factordependent on the radius.

• radius•

height• height type• cap height• subdivisions idth• subdivisions height• subdivisions cap

Spindle

( polygonal cylinder ith a conical cap oneach end. The cap heightis a factor dependent onthe radius.

• radius• height• height type• cap height• subdivisions idth• subdivisions height• subdivisions cap

Star



( polygonal star. Thetist parameter tiststhe tines.

• inner radius• outer radius• height• subdivisions idth %tines&• subdivisions height• tist

Flower

( polygonal 2loer# hich is basically acylinder ith extrudesides.

• inner radius• outer radius• height• subdivisions idth

%petals&• subdivisions height

Gear

( polygonal Cogheel.

The offset and taperattributes arenormali3ed factorsconcerning height orcog"dimensions.

• bore radius•

root radius• pitch radius• tip radius• height• subdivisions idth %cogs&• subdivisions height

%sections&• root offset• tip offset• height offset• cog idth•

inner offset• taper• tist

Standard Profile



( polygonal standardconstruction profile$ 4#5# U# T# , or "shape.

• idth• height• depth %length&• ith thic!ness• height thic!ness• subdivisions height• shape• splitCap

NURBS Curve Obe!ts:

Fillet Square ( NURBS curve s'uare ithrounded edges.

• side5ength6• side5ength7• fillet• fillet Radius• fillet as fraction• degree %linear or

cubic&

Four-Sided Object

Three different four"sidedshaped NURBS curves$ 8ite%includes Rhombus&#0arallelogram# Trape3ium.4as different modes# notethat not any attribute or!son any mode. (vailable only

as a linear curve at themoment.

• idth• height• side5ength6• side5ength6• (ngle• 9ffset• Shape 1ode % 6 or 7 &

Fillet -Gon



( NURBS curve N"gon ithrounded edges.

• radius• fillet• fillet Radius• segments• degree %linear or

cubic&

Star

( NURBS curve star. Thetist parameter tists thetines.

• radius 6 %inner&• radius 7 %outer&• tines• tist• degree %linear or

cubic&

Flower

( NURBS curve 2loer. • radius 6 %inner&• radius 7 %outer&• petals• degree %linear or

cubic&

Gear

( NURBS curve cogheel.The bevel# offset and taperattributes are normali3edfactors concerning cog"dimensions.

• root radius• pitch radius• tip radius• cogs• root offset• tip offset• cog idth• degree %linear or

cubic&• tist

Standard Profile



( standard construction"profile$ 4# 5# U# T# , or "shape. (vailable only as alinear curve at the moment.

• idth• height• idth thic!ness• height thic!ness• shape

" #m$ortant Noti!e

/n several cases it ould ma!e sense to limit certain attributes in connection to otherattributes values# e.g. radius6 should never be greater than radius7. 4oever that ouldcause the folloing problem$ /n 1aya# one can animate every attribute. So hat happens if to attributes are !eyframed# but one attribute limits the other: 9ne value ould be in astate hich does not correspond to hat you see in 1aya.2or that reason / decided not to implement any limitations beteen attributes. That maylead to unexpected or unusable results# it is the user;s responsibility to deal ith that.

% Note on t&e bevel !ube

Some people annotated about the corners of the bevel cube. (t the moment those arereali3ed li!e a cut"out 'uarter from a hemisphere. / am aare of that this is not the idealsolution because it 6& is not symmetrical and 7& contains triangles. The ay the bevel tool

or!s on corners seem to be better.4oever# the 'uestion hich ay to use surely arose hen designing this plug"ins. <henhaving a closer loo!# / found out that the bevel"ay causes bad results on highersubdivision count$

/ can;t really explain hat the problem is and if this is only a bug or a general problem.

4oever# because of that and because of the fact that also the bevel ay produces a



triangle %at least hen having an odd number of subdivisions& / decided to do it the other ay./ !no it is no good for smooth poly)Sub+ modeling but neither of the to ays is really.2urthermore all in my opinion those primitives are better suited in a non"organic poly

or!flo. Not that / ould bar someone from doing so =& but / personally just ouldn;t usethe bevel cube as a basis for smooth"poly modeling > in this case you just have other)better

means to get round edges.

' (no)n Bugs and *imitations

– no U?s are being generated on the polygon objects.

Documents

FePrimitives 0.9.1 Short Documentation