CGA 参考

抢先版本：

本页将提供 CGA 中可用的操作和功能的概览。 有关 CGA 形状语法的基础知识，请访问 CGA 建模基础知识。

运算

几何创建

envelope	extrude	footprint	i (insert)
insertAlongUV	offset	primitiveCone	primitiveCube
primitiveCylinder	primitiveDisk	primitiveQuad	primitiveSphere
roofGable	roofHip	roofPyramid	roofRidge
roofShed	taper

几何细分

comp	innerRectangle	scatter	setback
setbackPerEdge	setbackToArea	shapeL	shapeU
shapeO	split	splitArea	splitAndSetbackPerimeter

几何操作

cleanupGeometry	convexify	deleteHoles	reverseNormals
setNormals	softenNormals	mirror	rectify
reduceGeometry	resetGeometry	trim

几何标签

tag

deleteTags

setTagsFromEdgeAttrs

规则内联和 3D 布尔

内联

union

subtract

intersect

纹理

deleteUV	normalizeUV	projectUV	rotateUV
scaleUV	setupProjection	texture	tileUV
translateUV	copyUV

变换

center	r (scope rotate)	rotate	s (scope size)
t (scope translate)	translate

范围

alignScopeToAxes	alignScopeToGeometry	alignScopeToGeometryBBox	mirrorScope
rotateScope	setPivot

流程控制

NIL

pop

push

快捷菜单

label

属性

color	print	报表	resetMaterial
set	setMaterial

形状属性

形状属性是当前形状的属性。 此类属性可始终进行读取（与函数一样），其中一些可使用 set 操作进行设置。

comp	initialShape	material	pivot
scope	seedian	split	trim

内置函数

函数始终会返回一个值，并且不会更改当前形状（概率函数例外，此类函数会更改形状随机数生成器的状态）。

数学函数

abs	acos	asin	atan
atan2	ceil	cos	exp
floor	isinf	isnan	ln
log10	pow	rint	sin
sqrt	tan

概率函数

p

rand

转换函数

bool	boolArray	float	floatArray
isNull	sel	str	stringArray

字符串函数

count	find	len	splitString
substring

几何函数

geometry.angle	geometry.area	geometry.boundaryLength	geometry.{du|dv}
geometry.groups	geometry.hasTags	geometry.hasUVs	geometry.height
geometry.isClosedSurface	geometry.isConcave	geometry.isInstanced	geometry.isOriented
geometry.isPlanar	geometry.isRectangular	geometry.materials	geometry.nEdges
geometry.nFaces	geometry.nHoles	geometry.nVertices	geometry.tags
geometry.{uMin|uMax|vMin|vMax}	geometry.volume

材料函数

getMaterial

readMaterial

文件函数

fileExists	fileSearch / filesSearch	readFloatTable	readStringTable
readTextFile

资产和影像函数

assetInfo	assetMetadata	assetNamingInfo / assetNamingInfos	assetsSortRatio
assetsSortSize	imageInfo	imagesSortRatio

堆叠函数

inside

overlaps

touches

上下文函数

contextCompare

contextCount

minimumDistance

数组函数

array initialization	colon operator	comp	findFirst
index operator	nColumns	nRows	setElems
size	sortIndices	sortRowIndices	sum
transpose

边属性函数

edgeAttr.getBool

edgeAttr.getFloat

edgeAttr.getString

其他函数

convert	getGeoCoord	getTreeKey	print
Simple types operators	数组类型运算符

其他关键字

attr	const	extension	import
start	style	版本	with

CGA 实用工具函数库

字符串实用工具函数

findFirst	findLast	getPrefix	getRange
getSuffix	替换

字符串列表实用工具函数

字符串列表是存储在一个字符串内的一系列字符串。 各个元素以分号 (";") 分隔。 数据类型为“字符串”，因此与在其他脚本语言中不同，它不是任何实际类型的数组。

listAdd	listClean	listCount	listFirst
listFromArray	listIndex	listItem	listLast
listRandom	listRange	listRemove	listRemoveAll
listRetainAll	listSize	listTerminate	listToArray

文件、资产和图像实用工具函数

assetApproxRatio	assetApproxSize	assetBestRatio	assetBestSize
assetFitSize	fileBaseName	fileDirectory	fileExtension
fileName	fileRandom	imageApproxRatio	imageBestRatio

数学实用工具函数

clamp

min

max

颜色实用工具函数

colorHexToB	colorHexToG	colorHexToH	colorHexToO
colorHexToR	colorHexToS	colorHexToV	colorHSVToHex
colorHSVOToHex	colorRamp	colorRGBToHex	colorRGBOToHex

其他信息

CGA 更改日志	注记	资产搜索	内置资产
上下文和遮挡查询	欧拉角度	纹理	组件标签

要查看离线 CGA 参考，请单击 CityEngine 主菜单中的帮助 > 离线 CGA 参考。