壁フレーミング計算

間隔ゼロと正でない壁長さは invalid_input で拒否され、誤入力が無限ベイ数を生むことはありません。同じ純粋算術が無料のブラウザツールと API 経路を動かすため、土曜のスケッチと購買スクリプトが後で送る明細は成功項目あたり $0.002 で一致します。

スタッド・プレート・切断長さの数え方

骨組みの壁は抽象面積ではなく、スタッドとプレートとして買います。スタッド間隔は連続するスタッド間の芯々距離です。インチ作業では十六と二十四が住宅の既定ですが、長さと同じ単位で厳密に正の有限な任意の間隔を受け付けます。壁の長さが間隔のちょうど倍数のときは、式は長さを間隔で割って一を足すだけです。遠い端に部分ベイが残る場合でも閉じる端スタッドを数え、これは floor（長さを間隔で割った値）に二を足すのと同等です。開口は任意です。 openings の既定はゼロで、芯々レイアウトに加えてキングやジャックが必要な扉・窓の非負整数個を受け付けます。現場標準がジャックも数える場合は上げられます。プレートは別の木材系統です。組み立て中の壁のプレート長さを端から端まで、図面が用いる長さの単位で測り、その値を wall_length として送ります。仕上がり高さは、床下地から天井面、または二重上プレート上面までのことが多く、それを wall_height として送ります。エンジンは常にプレートの各端にスタッドを置き、stud_spacing ごとに中間位置を埋めます。この二通りから full_bays、remainder（端がグリッド上ならゼロ）、base_studs が得られます。extra_studs_per_opening の既定は二で、粗開口の両側にキングスタッド一本ずつの典型値です。opening_studs は openings に extra_studs_per_opening を掛けた値、stud_count は base_studs と opening_studs の和です。plate_count の既定は三で、下側一枚と二重上プレートという住宅の一般的な積みです。plate_linear は plate_count に wall_length を掛けた値です。高さと同じ単位で plate_thickness を送ると（インチのツーバイ材なら一・五）、stud_length は wall_height から plate_count に plate_thickness を掛けた値を引いたネットスタッドになり、省略時はゼロで stud_length は壁高さに等しくなります。stud_linear は stud_count に stud_length を掛けた値、total_pieces と total_linear は両系統の合計です。手法ラベルは常に oc_studs_plus_plates で、下流ログが安定した名前で分岐できます。

送る値、単位の扱い、エラーの動き

必須の有限数を三つと、任意の拾い出しつまみを送ります。壁をインチで測った場合は間隔もインチで送ります。十フィート区間なら百二十、標準芯々なら十六です。エンジンは単位換算をしないため、長さをフィート・間隔をインチと混在させると無意味なスタッド本数になります。openings の既定はゼロです。wall_length はプレートの走りで、length、wall、span の別名はそれらの名前を好むフォーム向けに受け付けます。wall_height は同じ長さ体系の仕上がり高さで、height と h の別名は短い列をカバーします。stud_spacing はその体系での芯々ピッチで、spacing、oc、on_center、centers の別名は一般的な拾い出し表の見出しをカバーします。ミリメートルやフィートで作業する場合はすべての長さフィールドをその体系に揃えます。extra_studs_per_opening の既定は二で上限は二十です。plate_count の既定は三で一から六の整数を受け付け、上プレート一枚なら plate_count を二にし、別エンドポイントは不要です。plate_thickness の既定はゼロで、高さがインチでツーバイのネット長さが欲しいときだけ一・五を送ります。必須欠落、空文字、非数値、NaN、Infinity はフィールド名付きの invalid_input で失敗し課金されません。ゼロまたは負の stud_spacing は、間隔は正の数でなければならずゼロ間隔は invalid_input である、というメッセージで失敗します。ゼロまたは負の wall_length は壁長さが正でないために失敗します。正でない wall_height も同様です。plate_count に plate_thickness を掛けた値が wall_height 以上なら、切断リストに長さゼロのスタッドが載らないよう失敗します。成功時の JSON は清掃済み入力のあと full_bays、remainder、base_studs、opening_studs、stud_count、stud_length、stud_linear、plate_linear、total_pieces、total_linear、formula 文字列、method oc_studs_plus_plates を返します。API 料金は成功項目あたり公表ベース $0.002 で、検証失敗は前払い残高を消費しません。

壁フレーミング計算が役立つ場面

十六インチ芯々と二十四インチ芯々を選ぶ改修では、同じ長さと高さで再実行し、ベイ格子が変わったときの stud_count と stud_linear の動きを見ます。それは下地の判断であり、面材の判断ではありません。本能力は純粋な parse エンジンのため、API 料金は成功項目あたり公表ベース $0.002 で、検証失敗は残高を消費しません。リクエストは小さく保ち、stud_count、plate_count、stud_length をテストに固定すれば、自前の CAD 核を立てずに見積・発注・エッジワーカー向けの再現可能なフレーミング拾い出しが得られます。