carla/PythonAPI/docs/blueprint.yml

275 lines
7.3 KiB
YAML
Raw Normal View History

2019-05-03 18:18:02 +08:00
---
- module_name: carla
doc: >
# - CLASSES ------------------------------
classes:
- class_name: ActorAttributeType
# - DESCRIPTION ------------------------
doc: >
Class that defines the type of attribute of a carla.ActorAttribute.
2019-05-03 18:18:02 +08:00
# - PROPERTIES -------------------------
instance_variables:
- var_name: Bool
doc: >
- var_name: Int
doc: >
- var_name: Float
doc: >
- var_name: String
doc: >
- var_name: RGBColor
doc: >
- class_name: Color
# - DESCRIPTION ------------------------
doc: >
2019-07-05 20:53:24 +08:00
Class that defines a 32-bit BGRA color.
2019-05-03 18:18:02 +08:00
# - PROPERTIES -------------------------
instance_variables:
- var_name: r
type: int
2019-05-03 18:18:02 +08:00
doc: >
Red color (0-255)
2019-05-03 18:18:02 +08:00
- var_name: g
type: int
2019-05-03 18:18:02 +08:00
doc: >
Green color (0-255)
2019-05-03 18:18:02 +08:00
- var_name: b
type: int
2019-05-03 18:18:02 +08:00
doc: >
Blue color (0-255)
2019-05-03 18:18:02 +08:00
- var_name: a
type: int
2019-05-03 18:18:02 +08:00
doc: >
Alpha channel (0-255)
2019-05-03 18:18:02 +08:00
# - METHODS ----------------------------
methods:
2019-07-01 23:46:27 +08:00
- def_name: __init__
params:
- param_name: r
type: int
default: 0
doc: >
- param_name: g
type: int
default: 0
doc: >
- param_name: b
type: int
default: 0
doc: >
- param_name: a
type: int
default: 255
doc: >
doc: >
Client constructor
# --------------------------------------
2019-05-03 18:18:02 +08:00
- def_name: __eq__
params:
- param_name: other
type: carla.Color
2019-05-03 18:18:02 +08:00
doc: >
# --------------------------------------
- def_name: __ne__
params:
- param_name: other
type: carla.Color
2019-05-03 18:18:02 +08:00
doc: >
# --------------------------------------
2019-07-01 23:46:27 +08:00
- def_name: __str__
doc: >
# --------------------------------------
2019-05-03 18:18:02 +08:00
- class_name: ActorAttribute
# - DESCRIPTION ------------------------
doc: >
2019-07-05 20:22:22 +08:00
Class that defines an attribute of a carla.ActorBlueprint.
2019-05-03 18:18:02 +08:00
# - PROPERTIES -------------------------
instance_variables:
- var_name: id
2019-07-01 23:46:27 +08:00
type: str
2019-05-03 18:18:02 +08:00
doc: >
The attribute's identifier
2019-05-03 18:18:02 +08:00
- var_name: type
2019-07-01 23:46:27 +08:00
type: carla.ActorAttributeType
2019-05-03 18:18:02 +08:00
doc: >
The attribute parameter type
2019-05-03 18:18:02 +08:00
- var_name: recommended_values
2019-07-01 23:46:27 +08:00
type: list(str)
2019-05-03 18:18:02 +08:00
doc: >
List of recommended values that the attribute may have.
2019-05-03 18:18:02 +08:00
- var_name: is_modifiable
2019-07-01 23:46:27 +08:00
type: bool
2019-05-03 18:18:02 +08:00
doc: >
True if the attribute is modifiable.
2019-05-03 18:18:02 +08:00
# - METHODS ----------------------------
methods:
- def_name: as_bool
doc: >
# --------------------------------------
- def_name: as_int
doc: >
# --------------------------------------
- def_name: as_float
doc: >
# --------------------------------------
- def_name: as_str
doc: >
# --------------------------------------
- def_name: as_color
doc: >
# --------------------------------------
- def_name: __eq__
2019-07-01 23:46:27 +08:00
params:
- param_name: other
type: bool / int / float / str / carla.Color / carla.ActorAttribute
2019-05-03 18:18:02 +08:00
doc: >
# --------------------------------------
- def_name: __ne__
2019-07-01 23:46:27 +08:00
params:
- param_name: other
type: bool / int / float / str / carla.Color / carla.ActorAttribute
2019-05-03 18:18:02 +08:00
doc: >
# --------------------------------------
- def_name: __nonzero__
doc: >
# --------------------------------------
- def_name: __bool__
doc: >
# --------------------------------------
- def_name: __int__
doc: >
# --------------------------------------
- def_name: __float__
doc: >
# --------------------------------------
- def_name: __str__
doc: >
# --------------------------------------
2019-07-01 23:46:27 +08:00
- def_name: __str__
doc: >
# --------------------------------------
2019-05-03 18:18:02 +08:00
- class_name: ActorBlueprint
# - DESCRIPTION ------------------------
doc: >
2019-07-05 20:22:22 +08:00
Class that contains all the necessary information for spawning an Actor.
2019-05-03 18:18:02 +08:00
# - PROPERTIES -------------------------
instance_variables:
- var_name: id
2019-07-01 23:46:27 +08:00
type: str
2019-05-03 18:18:02 +08:00
doc: >
Actor blueprint identifier, e.g. `walker.pedestrian.0001`.
2019-05-03 18:18:02 +08:00
- var_name: tags
2019-07-01 23:46:27 +08:00
type: list(str)
2019-05-03 18:18:02 +08:00
doc: >
List of tags of an actor blueprint e.g. `['0001', 'pedestrian', 'walker']`
2019-05-03 18:18:02 +08:00
# - METHODS ----------------------------
methods:
- def_name: has_tag
return: bool
2019-07-01 23:46:27 +08:00
params:
- param_name: tag
type: str
doc: >
e.g. 'walker'
2019-05-03 18:18:02 +08:00
doc: >
Returns `true` if an actor blueprint has the tag.
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: match_tags
return: bool
2019-07-01 23:46:27 +08:00
params:
- param_name: wildcard_pattern
type: str
2019-05-03 18:18:02 +08:00
doc: >
Test if any of the flags or id matches wildcard_pattern.
2019-07-01 23:46:27 +08:00
note: >
The wildcard_pattern follows Unix shell-style wildcards.
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: has_attribute
return: bool
2019-07-01 23:46:27 +08:00
params:
- param_name: id
type: str
doc: >
e.g 'gender'
2019-05-03 18:18:02 +08:00
doc: >
Returns `true` if the blueprint contains the specified attribute
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: get_attribute
return: carla.ActorAttribute
2019-07-01 23:46:27 +08:00
params:
- param_name: id
type: str
2019-05-03 18:18:02 +08:00
doc: >
Returns the current actor attribute through its id
2019-07-01 23:46:27 +08:00
Return: carla.ActorAttribute
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: set_attribute
2019-07-01 23:46:27 +08:00
params:
- param_name: id
type: str
doc: >
# --------------------------------------
- param_name: value
type: str
doc: >
2019-05-03 18:18:02 +08:00
doc: >
Sets an existing attribute to the actor's blueprint
note: >
Attribute can only be set or changed if it is modifiable
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: __len__
doc: >
# --------------------------------------
- def_name: __iter__
doc: >
# --------------------------------------
2019-07-01 23:46:27 +08:00
- def_name: __str__
doc: >
# --------------------------------------
2019-05-03 18:18:02 +08:00
- class_name: BlueprintLibrary
# - DESCRIPTION ------------------------
doc: >
Class that provides access to [blueprints](../bp_library/).
2019-05-03 18:18:02 +08:00
# - METHODS ----------------------------
methods:
- def_name: find
params:
- param_name: id
type: str
return: carla.ActorBlueprint
2019-05-03 18:18:02 +08:00
doc: >
Returns a carla.ActorBlueprint through its id
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: filter
2019-07-01 23:46:27 +08:00
params:
- param_name: wildcard_pattern
type: str
2019-05-03 18:18:02 +08:00
doc: >
2019-07-01 23:46:27 +08:00
Filters a list of ActorBlueprint with id or tags matching wildcard_pattern.
The pattern is matched against each blueprint's id and tags.
note: >
The wildcard_pattern follows Unix shell-style wildcards (fnmatch).
return: carla.BlueprintLibrary
2019-05-03 18:18:02 +08:00
# --------------------------------------
- def_name: __getitem__
params:
- param_name: pos
type: int
return: carla.ActorBlueprint
2019-05-03 18:18:02 +08:00
doc: >
# --------------------------------------
- def_name: __len__
doc: >
# --------------------------------------
- def_name: __iter__
doc: >
# --------------------------------------
2019-07-01 23:46:27 +08:00
- def_name: __str__
doc: >
# --------------------------------------
2019-05-03 18:18:02 +08:00
...