指定されたパラメータで、Elastic を作成します。
説明
作成された
Elastic のパラメータは、ユーザーにより指定されるキーワード引数により定義されます。
minimum-size: Distance として指定された最小サイズです。既定値は、0m です。
preferred-size: Distance として指定されたユーザー設定サイズです。既定値は、0m です。
compressibility: double として指定された圧縮係数です。既定値は、1.0 です。
stretchiness: double として指定された伸長係数です。既定値は 1.0 です。
dest:
dest の具象タイプが結果に適合する場合に、結果の格納先となる
Elastic です。
dest が指定されていない場合、または null の場合、新しく割り当てられたエラスティックが返されます。
戻り値
作成された Elastic です。キーワード引数として指定されない(もしくは null として指定されている)パラメータは、いくつかの例外を除き、上記にリストされた既定値を受け取ります。
- ユーザーの設定で指定されたサイズが特定の最小値より小さい場合、ユーザー設定サイズは最小サイズと同じサイズまで増やされます。
- 指定の結果が Elastic の最小サイズとユーザー設定サイズが同じになる場合(前項で説明した、ユーザー指定のサイズが最小サイズより小さいケースを含む)、圧縮順位の既定値は高く設定され、圧縮係数は 1.0 に設定されます。
- (a) 結果 Elastic のユーザー設定サイズが最小サイズよりも大きい場合、そして (b) compressibility または compress-order キーワード引数、あるいはその両方が提供されていない(もしくは null に指定されている)場合、さらに圧縮係数が指定されていないとその値は Elastic の伸長係数と等しくなり、また同様に生成される Elastic の圧縮順位が指定されていないとその値は Elastic の伸長順にと等しくなります。
注意事項
最小サイズおよびユーザー設定サイズに指定できる単位には制限があります。これらは、解像度の影響を受けない単位を表す、
Distance でなくてはなりません。このような単位の例として、
cm、
in、
pt が挙げられます。
pixel や
px などの、解像度の影響を受ける単位は使用しないでください。サポート対象の
Distance 単位の完全リストについては、「
数量と単位」の章を参照してください。