Skip to content

パーツ設定

標準設定はGameData/PyLoN/Parts/*/part.cfgにあります。変更後はKSPを再起動してDLLとCFGを読み直してください。

LiDAR共通

Key内容
sensorMode2Dまたは3D
horizontalLaserCount2Dの水平ray数。UI上1〜2048
verticalLaserCount矩形走査の垂直ray数。UI上1〜128
horizontalFovDegrees0〜360°
verticalFovDegrees0〜180°
maxDistance最大測距距離[m]
scanRateHz1〜60 Hz
streamAt20Fps有効時はscanRateHzを無視して20 Hz
udpEnabledUDP送信の有効・無効
lidarEnabledFlightスキャンの有効・無効
ignoreOwnVessel自機collisionを除外
forwardAxis / upAxis2Dまたは手動3Dのパーツlocal軸
rayOriginLocalPositionray原点のパーツlocal座標
originOffsetMeters原点から前方への追加offset
noHitValueUDP上の未ヒット値。既定-1
maxLaserCount1 scanのray上限。既定4096
maxDatagramBytesLiDAR JSON datagram上限。既定60000
includeHitPointshit座標をUDP JSONへ含める
includeDirectionsray方向をUDP JSONへ含める

3D標準パーツはalign3DToAttachNormal = trueで、取付面の外向き法線を半球前方に使います。手動軸へ切り替える場合だけfalseにします。

3D LiDAR profile

Key既定値UI範囲
rangeProfilemediumnear / medium / long
nearRangeMeters3010〜30 m
mediumRangeMeters10050〜150 m
longRangeMeters250150〜250 m
hemisphereDensityprofile選択時に160 / 320 / 10241〜1024 rays/sr

共通設定と機体モデル

GameData/PyLoN/Config/Runtime.cfgで管理します。センサーパーツの有無に依存しません。

NodeKey既定値内容
PYLON_TRANSPORTstateHost / statePort127.0.0.1 / 49010bridgeへの送信先
PYLON_TRANSPORTcommandPort49011command受信port
PYLON_MODELenabledtrue機体モデル送信
PYLON_MODELrefreshSeconds2再送間隔
PYLON_MODELchunkBytes / maxChunks12000 / 256圧縮モデル分割上限
PYLON_MODELallowRemoteUrdffalseloopback以外への送信許可

センサーIDは各パーツのModulePyLoNSensorId.sensorIdで設定します。ユーザーが設定したIDは改名しません。

RGBカメラ

Key既定値内容
imageWidth / imageHeight320 / 240解像度
frameRateHz51〜15 Hz
verticalFovDegrees6020〜120°
useGameClipPlanestrueゲームカメラの描画範囲を維持し、遠方の地形・雲を含める
nearClipMeters / farClipMeters0.05 / 20000useGameClipPlanes = false時のローカルclip plane制限
frameChunkBytes120001 UDP chunkのraw byte数
maxFrameBytes4194304raw RGB frame上限
maxFrameChunks512KSP側のchunk上限
cameraEnabled / udpEnabledtruecapture / UDP送信
cameraTiltDegrees90本体の上下首振り。0〜180°、craft/セーブに永続化
cameraPivotTransformNameCameraPivotローカルX軸で回転する本体。0°の基準回転はidentity
cameraOpticalTransformNameCameraOptical回転本体内の撮影基準Transform。+Zが撮影方向、+Yが画像上方向
cameraOriginLocalPosition0, 0, -0.272光学Transformがないモデルで使う撮影原点
forwardAxis / upAxis-Z / +Y光学Transformがない場合のcamera local軸

モーター共通

Keyサーボ既定リニア既定内容
motorNameROS joint名。空ならIDから生成
stateRateHz2020state送信Hz。実行時1〜60へclamp
commandTimeoutSeconds0.50.5velocity mode timeout
定格effortratedEffortNm = 250ratedEffortN = 4000effort上限
電流換算torquePerAmpNm = 40forcePerAmpN = 800推定電流用

PyLoNを使ったROS2アプリケーション開発のためのガイドとAPIリファレンス