Skip to content

Commit 3749520

Browse files
committed
PythonAPI校正
1 parent cf792a1 commit 3749520

File tree

5 files changed

+21
-19
lines changed

5 files changed

+21
-19
lines changed

docs/adv_synchrony_timestep.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -179,7 +179,7 @@ while True:
179179
世界具有异步方法,可以让客户端等待服务器的时间步进,或在收到时执行某些操作。
180180

181181
```py
182-
# 等待下一个滴答信息并检索该节拍的快照
182+
# 等待下一个节拍信息并检索该节拍的快照
183183
world_snapshot = world.wait_for_tick()
184184

185185
# 注册一个回调函数,每次接收到新快照时调用它。

docs/interbehavior/Usage.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
- **转向** - `A` 表示左转,`D` 表示右转
2323
- **刹车** - 按住 `S` 即可
2424
- **切换倒车** - 通过按 `Alt` 进行倒车和前进(屏幕分别显示`R``D`)的切换
25-
- **转向信号** - 均可通过按 `Q`(左)或 `E`(右)来实现,在屏幕中显示红色的`<<<``>>>`只报4声滴答
25+
- **转向信号** - 均可通过按 `Q`(左)或 `E`(右)来实现,在屏幕中显示红色的`<<<``>>>`只报4声节拍信号
2626
- **相机调整** - 使用箭头键(上、下、左、右)在 X 和 Y 轴上进行调整,使用 `pg-up/pg-down` 按钮在 Z 轴上进行调整
2727
- **更改摄像机视图位置** - 使用 `Tab` 切换到 `DReyeVRParams.ini` 中定义的下一个摄像机位置。按 `Shift+Tab` 可切换回上一个摄像机位置
2828
- **更改相机着色器** - 使用 `.`(句点)切换到下一个着色器,使用 `,`(逗号)切换到上一个着色器

docs/modules/Server.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -66,10 +66,10 @@
6666
- **void RunSome(uint32 Milliseconds)**
6767
- 运行服务器一段时间,传入时间(以毫秒为单位,Milliseconds)参数,在指定时长内执行服务器相关的逻辑,比如处理数据、更新状态等。
6868
- **void Tick()**
69-
- 执行服务器的一次“滴答”操作,通常用于周期性地更新服务器状态、处理数据等,类似于游戏循环里的每一帧更新逻辑。
69+
- 执行服务器的一次“节拍”操作,通常用于周期性地更新服务器状态、处理数据等,类似于游戏循环里的每一帧更新逻辑。
7070

7171
- **bool TickCueReceived()**
72-
- 检查是否接收到了“滴答”提示(Tick Cue),返回布尔值表示是否收到,可用于判断是否需要进行下一步相关操作等。
72+
- 检查是否接收到了“节拍”提示(Tick Cue),返回布尔值表示是否收到,可用于判断是否需要进行下一步相关操作等。
7373

7474
### 数据流管理
7575

@@ -122,7 +122,7 @@
122122
- 当前 CARLA Episode 的指针,用于管理模拟场景。
123123

124124
- **std::atomic_size_t TickCuesReceived**
125-
- 用于记录接收到的“滴答”提示数量。
125+
- 用于记录接收到的“节拍信号”提示数量。
126126

127127

128128

docs/python_api.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -770,7 +770,7 @@ Y 像素坐标。
770770
- `thickness` (_float<small> - 米</small>_) - 线的密度。
771771
- `arrow_size` (_float<small> - 米</small>_) - 箭头尖端的大小。
772772
- `color` (_[carla.Color](#carla.Color)_) - 用于为对象着色的 RGB 代码。默认为红色。
773-
- `life_time` (_float<small> - seconds</small>_) - 形状的生命周期。默认情况下它只持续一帧。将其设置<code>0</code>为永久形状。
773+
- `life_time` (_float<small> - </small>_) - 形状的生命周期。默认情况下它只持续一帧。将其设置<code>0</code>为永久形状。
774774
- <a name="carla.DebugHelper.draw_box"></a>**<font color="#7fb800">draw_box</font>**(<font color="#00a6ed">**self**</font>, <font color="#00a6ed">**box**</font>, <font color="#00a6ed">**rotation**</font>, <font color="#00a6ed">**thickness**=0.1</font>, <font color="#00a6ed">**color**=(255,0,0)</font>, <font color="#00a6ed">**life_time**=-1.0</font>)<button class="SnipetButton" id="carla.DebugHelper.draw_box-snipet_button">snippet &rarr;</button>
775775
绘制一个框,通常用于对象碰撞体。
776776
- **参数:**
@@ -825,15 +825,15 @@ Y 像素坐标。
825825
- `location` (_[carla.Location](#carla.Location)<small> - 米</small>_) - 在坐标系中点以将对象居中。
826826
- `size` (_float<small> - 米</small>_) - 点的密度。
827827
- `color` (_[carla.Color](#carla.Color)_) - 用于为对象着色的 RGB 代码。默认为红色。
828-
- `life_time` (_float<small> - seconds</small>_) - 形状的生命周期。默认情况下它只持续一帧。将其设置<code>0</code>为永久形状。
828+
- `life_time` (_float<small> - </small>_) - 形状的生命周期。默认情况下它只持续一帧。将其设置<code>0</code>为永久形状。
829829
- <a name="carla.DebugHelper.draw_string"></a>**<font color="#7fb800">draw_string</font>**(<font color="#00a6ed">**self**</font>, <font color="#00a6ed">**location**</font>, <font color="#00a6ed">**text**</font>, <font color="#00a6ed">**draw_shadow**=False</font>, <font color="#00a6ed">**color**=(255,0,0)</font>, <font color="#00a6ed">**life_time**=-1.0</font>)<button class="SnipetButton" id="carla.DebugHelper.draw_string-snipet_button">snippet &rarr;</button>
830830
在模拟的给定位置绘制一个字符串,该字符串只能在服务器端看到。
831831
- **参数:**
832832
- `location` (_[carla.Location](#carla.Location)<small> - 米</small>_) - 模拟中文本居中的位置。
833833
- `text` (_str_) - 旨在向世界展示的文本。
834834
- `draw_shadow` (_bool_) - 为字符串投射阴影,有助于可视化。默认情况下它是禁用的。
835835
- `color` (_[carla.Color](#carla.Color)_) - 用于为字符串着色的 RGB 代码。默认为红色。
836-
- `life_time` (_float<small> - seconds</small>_) - 形状的生命周期。默认情况下它只持续一帧。将其设置<code>0</code>为永久形状。
836+
- `life_time` (_float<small> - </small>_) - 形状的生命周期。默认情况下它只持续一帧。将其设置<code>0</code>为永久形状。
837837
- <a name="carla.DebugHelper.clear_debug_shape"></a>**<font color="#7fb800">clear_debug_shape</font>**(<font color="#00a6ed">**self**</font></font>)
838838
清除模拟器上的所有调试形状。
839839
- <a name="carla.DebugHelper.clear_debug_string"></a>**<font color="#7fb800">clear_debug_string</font>**(<font color="#00a6ed">**self**</font></font>)
@@ -913,6 +913,7 @@ Alpha 通道。
913913
如果不允许静态闪电,Alpha 通道将包含环境光遮挡。
914914
- <a name="carla.GBufferTextureID.GBufferD"></a>**<font color="#f8805a">GBufferD</font>**
915915
“GBufferD”的内容根据渲染对象的材质着色模型 (GBufferB) 的不同而有所不同:<br>
916+
916917
- MSM_Subsurface (2), MSM_PreintegratedSkin (3), MSM_TwoSidedFoliage (6):<br>
917918
RGB: 次表面颜色。<br>
918919
A: 不透明度。<br>
@@ -931,6 +932,7 @@ Alpha 通道。
931932
RG: 眼切线。<br>
932933
B: 虹膜掩模。<br>
933934
A: 虹膜距离。
935+
934936
- <a name="carla.GBufferTextureID.GBufferE"></a>**<font color="#f8805a">GBufferE</font>**
935937
纹理“GBufferE”包含 RGBA 通道中预先计算的阴影因子。如果选择性输出掩码 (GBufferB) 没有设置其第 4 位,则此纹理不可用。
936938
- <a name="carla.GBufferTextureID.GBufferF"></a>**<font color="#f8805a">GBufferF</font>**
@@ -2484,10 +2486,10 @@ _</font>
24842486
返回一个路径点列表,指示交通信号灯产生影响的位置和车道。
24852487
- **返回:** _list([carla.Waypoint](#carla.Waypoint))_
24862488
- <a name="carla.TrafficLight.get_elapsed_time"></a>**<font color="#7fb800">get_elapsed_time</font>**(<font color="#00a6ed">**self**</font>)
2487-
客户端根据上次滴答信息返回自当前灯光状态开始以来的时间(秒)。该方法不调用模拟器。
2489+
客户端根据上次节拍信号返回自当前灯光状态开始以来的时间(秒)。该方法不调用模拟器。
24882490
- **返回:** _float<small> - seconds</small>_
24892491
- <a name="carla.TrafficLight.get_green_time"></a>**<font color="#7fb800">get_green_time</font>**(<font color="#00a6ed">**self**</font>)
2490-
客户端根据最后一个滴答信息返回为绿灯设置的时间。该方法不调用模拟器。
2492+
客户端根据最后一个节拍信号返回为绿灯设置的时间。该方法不调用模拟器。
24912493
- **返回:** _float<small> - seconds</small>_
24922494
- **设置器:** _[carla.TrafficLight.set_green_time](#carla.TrafficLight.set_green_time)_
24932495
- <a name="carla.TrafficLight.get_group_traffic_lights"></a>**<font color="#7fb800">get_group_traffic_lights</font>**(<font color="#00a6ed">**self**</font>)
@@ -2505,18 +2507,18 @@ _</font>
25052507
返回将其标识为交叉口交通信号灯组一部分的杆的索引。
25062508
- **返回:** _int_
25072509
- <a name="carla.TrafficLight.get_red_time"></a>**<font color="#7fb800">get_red_time</font>**(<font color="#00a6ed">**self**</font>)
2508-
客户端根据最后一个滴答信息返回交通信号灯变红的时间设置。该方法不调用模拟器。
2510+
客户端根据最后一个节拍信号返回交通信号灯变红的时间设置。该方法不调用模拟器。
25092511
- **返回:** _float<small> - seconds</small>_
25102512
- **设置器:** _[carla.TrafficLight.set_red_time](#carla.TrafficLight.set_red_time)_
25112513
- <a name="carla.TrafficLight.get_state"></a>**<font color="#7fb800">get_state</font>**(<font color="#00a6ed">**self**</font>)
2512-
客户端根据最后一个滴答信息返回交通信号灯的状态。该方法不调用模拟器。
2514+
客户端根据最后一个节拍信号返回交通信号灯的状态。该方法不调用模拟器。
25132515
- **返回:** _[carla.TrafficLightState](#carla.TrafficLightState)_
25142516
- **设置起:** _[carla.TrafficLight.set_state](#carla.TrafficLight.set_state)_
25152517
- <a name="carla.TrafficLight.get_stop_waypoints"></a>**<font color="#7fb800">get_stop_waypoints</font>**(<font color="#00a6ed">**self**</font>)
25162518
返回指示交通信号灯停止位置的路点列表。这些路点是根据交通信号灯的触发框计算出来的,这些触发框指示车辆应该停在哪里。
25172519
- **返回:** _list([carla.Waypoint](#carla.Waypoint))_
25182520
- <a name="carla.TrafficLight.get_yellow_time"></a>**<font color="#7fb800">get_yellow_time</font>**(<font color="#00a6ed">**self**</font>)
2519-
客户端根据最后一个滴答信息返回为交通信号灯设置为黄色的时间。该方法不调用模拟器。
2521+
客户端根据最后一个节拍信号返回为交通信号灯设置为黄色的时间。该方法不调用模拟器。
25202522
- **返回:** _float<small> - 秒</small>_
25212523
- **设置器:** _[carla.TrafficLight.set_yellow_time](#carla.TrafficLight.set_yellow_time)_
25222524

@@ -3710,7 +3712,7 @@ _</font>
37103712
- <a name="carla.World.wait_for_tick"></a>**<font color="#7fb800">wait_for_tick</font>**(<font color="#00a6ed">**self**</font>, <font color="#00a6ed">**seconds**=10.0</font>)
37113713
该方法使用 [异步模式](adv_synchrony_timestep.md) 。它使客户端等待服务器的节拍信号。当计算下一帧时,服务器将发出节拍信号并返回描述世界新状态的快照。
37123714
- **参数:**
3713-
- `seconds` (_float<small> - seconds</small>_) - 服务器等待滴答的最长时间。默认设置为 <code>10.0</code>。
3715+
- `seconds` (_float<small> - </small>_) - 服务器等待节拍信号的最长时间。默认设置为 <code>10.0</code>。
37143716
- **返回:** _[carla.WorldSnapshot](#carla.WorldSnapshot)_
37153717

37163718
##### 设置器
@@ -3823,7 +3825,7 @@ _</font>
38233825

38243826
### 实例变量
38253827
- <a name="carla.WorldSettings.synchronous_mode"></a>**<font color="#f8805a">synchronous_mode</font>** (_bool_)
3826-
表示客户端和服务器之间的同步。当设置为 true 时,服务器将等待客户端滴答以便继续前进。默认情况下为 false。
3828+
表示客户端和服务器之间的同步。当设置为 true 时,服务器将等待客户端节拍信号以便继续前进。默认情况下为 false。
38273829
- <a name="carla.WorldSettings.no_rendering_mode"></a>**<font color="#f8805a">no_rendering_mode</font>** (_bool_)
38283830
启用后,模拟将根本不运行渲染。这主要用于避免繁忙交通模拟期间的开销。默认情况下为 false。
38293831
- <a name="carla.WorldSettings.fixed_delta_seconds"></a>**<font color="#f8805a">fixed_delta_seconds</font>** (_float_)
@@ -4253,9 +4255,9 @@ Actor affected by the command.
42534255
- `transform` (_[carla.Transform](#carla.Transform)_)
42544256
- `parent` (_[carla.Actor](#carla.Actor) or int_)
42554257
- <a name="command.SpawnActor.then"></a>**<font color="#7fb800">then</font>**(<font color="#00a6ed">**self**</font>, <font color="#00a6ed">**command**</font>)
4256-
链接一个其他将要立刻执行的命令。它允许ease非常常见的流,比如通过命令生成一组车辆,并使用该方法设置自动驾驶。
4258+
链接一个其他将要立刻执行的命令。它可以简化一些常见的流程,比如通过命令生成一组车辆,并使用该方法设置自动驾驶。
42574259
- **参数:**
4258-
- `command` (_any carla Command_) - 一个 Carla 命令。
4260+
- `command` (_任何 carla 命令_) - 一个 Carla 命令。
42594261

42604262
---
42614263
[comment]: <> (=========================)

docs/ref_sensors.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -753,7 +753,7 @@ raw_image.save_to_disk("path/to/save/converted/image",carla.cityScapesPalette)
753753
| `fov` | float | 90\.0 | 水平视野(以度为单位)。 |
754754
| `image_size_x` | int | 800 | 图像宽度(以像素为单位)。 |
755755
| `image_size_y` | int | 600 | 图像高度(以像素为单位)。 |
756-
| `sensor_tick` | float | 0\.0 | 传感器捕获之间的模拟秒数(滴答声)。 |
756+
| `sensor_tick` | float | 0\.0 | 传感器捕获之间的模拟秒数(节拍信号)。 |
757757

758758

759759

@@ -1041,7 +1041,7 @@ Carla 目前支持模拟简单的广播无线信道和两条应用消息。尚
10411041
#### 自定义 V2X 消息 <span id="custom-v2x-message"></span>
10421042

10431043
* __蓝图:__ sensor.other.v2x_custom
1044-
* __输出:__ [carla.CustomV2XData](python_api.md#carla.CustomV2XData),在调用 *send()* 后触发下一个滴答信息
1044+
* __输出:__ [carla.CustomV2XData](python_api.md#carla.CustomV2XData),在调用 *send()* 后触发下一个节拍信息
10451045

10461046
##### 方法
10471047
- <a name="carla.Sensor.send"></a>**<font color="#7fb800">send</font>**(<font color="#00a6ed">**self**</font>, <font color="#00a6ed">**callback**</font>)

0 commit comments

Comments
 (0)