LlReplaceEnvironment/ja

From Second Life Wiki
Jump to navigation Jump to search

要約

関数: Integer llReplaceEnvironment( vector position, string environment, integer track_no, integer day_length, integer day_offset );

llReplaceEnvironment関数は、パーセルまたはリージョンの環境を置き換えます。単一の高度トラックまたは全体の環境に対応します。スクリプトの所有者は、宛先パーセルで環境を編集する権限を持っているか、リージョン全体の場合はエステートマネージャである必要があります。 ほとんどの場合、エラーは関数からの戻り値として報告されます(以下の表を参照)。ただし、環境アセットに関する問題はデバッグチャットで報告される場合があります。
Integer で返します。

• vector position 新しい環境を受け取るパーセルのリージョン内の位置。リージョン全体を変更するには<-1, -1, -1>を使用します。ベクトルのZ成分は無視されます。
• string environment オブジェクトのインベントリ内の環境設定の名前または環境のアセットID。環境を削除するにはNULL_KEYまたは空の文字列を使用します。
• integer track_no 変更する高度ゾーン。水域の場合は0、地上の場合は1、空の高度1000mの場合は2、空の高度2000mの場合は3、空の高度3000mの場合は4。すべてのトラックを変更するには-1。
• integer day_length 日サイクルの秒数。変更しない場合は-1。
• integer day_offset UTCからの秒単位のオフセット。変更しない場合は-1。

Return Values
Value Constant Description
1 地パーセルまたはリージョンは適用されている環境を変更しようとします。
ENV_NO_ENVIRONMENT -3 環境インベントリオブジェクトが見つかりませんでした。
ENV_THROTTLE -8 スクリプトがスロットルを超えています。待ってからリクエストを再試行してください。
ENV_NO_PERMISSIONS -9 スクリプトには選択した場所で環境を変更する権限がありません。
または
標高トラック 0 または 1 を削除しようとした場合(その場合、デバッグチャネルにもメッセージがチャットされます)。

警告

  • ビューアでローカルに設定された環境は、この関数から設定された環境を上書きします。
  • llSetEnvironment によって設定されたパラメータのオーバーライドは、この関数によって環境が置き換えられた後も保持されます。余分なオーバーライドをクリアするには、空のリストパラメータで llSetEnvironment を呼び出します。
  • この関数によって指定された環境は非同期で適用されます。シミュレータは環境アセットをダウンロードして適用する必要があるため、llGetEnvironment は新しい環境のパラメータをすぐに反映しません。ただし、遅延は通常非常に小さいです。
  • 環境パラメータとしてUUIDが渡され、そのUUIDが環境設定を指定していないか、構築できない場合、関数は成功(1)を返しますが、デバッグチャネルにメッセージを投稿します。

サンプル

//  Will set the entire region to the "Tropicalia" EEP from the Linden inventory when touched. 
//  It will set all the tracks to the same EEP with 24 hour day and a -8 hour Day Offset.
//  The "Tropicalia" must be in the prims inventory with the script.  
//
//  Limited to Estate Managers or Region owners.
//  Madi Perth - 4/17/2023

default
{

    touch_start(integer total_number)
    {
        llReplaceEnvironment(<-1, -1, -1>, "Tropicalia", -1, 86400, (86400-28800));
    }
}

関連項目

特記事項

経緯

Date of Release 12/08/2022

Search JIRA for related Issues

Signature

function Integer llReplaceEnvironment( vector position, string environment, integer track_no, integer day_length, integer day_offset );
この翻訳は 原文 と比べて古いですか?間違いがありますか?読みにくいですか?みんなで 修正 していきましょう! (手順はこちら)
この項目はあなたにとって参考にならない項目ですか?もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。