{"schema":"draw-settings/1","settings":{"$defs":{"StampFieldsV1":{"additionalProperties":false,"description":"The title-block values a caller may fill.\n\nBuilt from ``service.stampfields.stored_keys()`` — the one list the form, the storage, the re-stamp path, the job search and the gates all walk. Free text with a sanity cap; the stamp renderer's own overflow rule handles real length.","properties":{"company":{"default":"","maxLength":1903,"title":"Company","type":"string"},"project_name":{"default":"","maxLength":1903,"title":"Project Name","type":"string"},"customer":{"default":"","maxLength":1903,"title":"Customer","type":"string"},"planner":{"default":"","maxLength":1903,"title":"Planner","type":"string"},"drawn_by":{"default":"","maxLength":86,"title":"Drawn By","type":"string"},"plan_number":{"default":"","maxLength":104,"title":"Plan Number","type":"string"},"revision":{"default":"","maxLength":43,"title":"Revision","type":"string"},"date_text":{"default":"","maxLength":74,"title":"Date Text","type":"string"},"disclaimer":{"default":"","maxLength":548,"title":"Disclaimer","type":"string"}},"title":"StampFieldsV1","type":"object"}},"$id":"draw-settings/1","additionalProperties":false,"description":"One v1 drawing request's settings, defaults = the core's own.\n\n``extra=\"forbid\"``: an unknown key is a caller error under a\nversioned schema, never something to ignore — ignoring it would let\na v2 request silently render as v1.","properties":{"view_set":{"default":"by_content","enum":["three_view","six_view","by_content"],"title":"View Set","type":"string"},"paper_name":{"default":"A4","description":"The sheet the drawing STARTS on, before automatic paper selection climbs. Where paper_allowed is given and does not contain this sheet, the start is taken from that set instead — its smallest sheet — so a caller who names an allowed set gets that set, exactly as the website's form derives the start from the sheets a visitor ticks. The effective value is in the job the service answers with.","enum":["A4","A3","A2","A1","A0","ANSI A","ANSI B","ANSI C","ANSI D","ANSI E"],"title":"Paper Name","type":"string"},"paper_landscape":{"default":false,"title":"Paper Landscape","type":"boolean"},"scale_denominator":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"A rung of the fixed ladder, or null for automatic. The ISO rungs are always available; the five non-ISO rungs are available only when non_iso_scales is true, and naming one with that switch off is refused rather than rounded.","enum":[null,1,2,3,4,5,10,15,20,25,30,50,100],"title":"Scale Denominator"},"non_iso_scales":{"default":false,"description":"Widen the scale ladder by five declared non-ISO rungs (1:3, 1:4, 1:15, 1:25, 1:30). Off by default. The ladder stays fixed and finite either way — an odd fitted scale is never invented. A drawing on one of these rungs is a lawful drawing; if you have to hand ISO-conforming sheets to somebody else, leave this off.","title":"Non Iso Scales","type":"boolean"},"projection_lines":{"default":true,"title":"Projection Lines","type":"boolean"},"projection_detail_lines":{"default":true,"description":"The per-feature detail projection lines (bore centres, groove flanks), the core's second projection switch. Same PROJECTION layer as projection_lines, its own switch since B16.","title":"Projection Detail Lines","type":"boolean"},"projection_detail_mode":{"default":"all","description":"Which features get detail projection lines while projection_detail_lines is on: 'all' (the default) draws a line per feature station, as before; 'dim_linked' keeps only the lines that bridge a feature to a dimension sitting in another view and drops the rest as clutter. The schema default is the core's own 'all', so a request that never names it renders exactly what it rendered before.","enum":["all","dim_linked"],"title":"Projection Detail Mode","type":"string"},"projection_color_hex":{"default":"#5A96C8","title":"Projection Color Hex","type":"string"},"projection_alpha_pct":{"default":0,"maximum":100,"minimum":0,"title":"Projection Alpha Pct","type":"integer"},"hidden_color_hex":{"default":"#000000","description":"The hidden-edge ink's colour as #RRGGBB. The default is the core's own, so a request that never names it renders exactly what it rendered before.","title":"Hidden Color Hex","type":"string"},"contour_color_hex":{"default":"#000000","description":"The part contour's ink colour as #RRGGBB. The default is the core's own, so a request that never names it renders exactly what it rendered before.","title":"Contour Color Hex","type":"string"},"dimension_color_hex":{"default":"#000000","description":"The dimension ink's colour (line, extension lines, arrows, measure text) as #RRGGBB. The schema default is the core's plain export black (V5: an unnamed field renders exactly what it always rendered); the WEB PAGE prefills its upload form with the core's own technical blue and sends that unless the visitor picks another colour (V26).","title":"Dimension Color Hex","type":"string"},"sheet_pictogram":{"default":true,"description":"The small 3D picture of the part beside the title block, showing which way round the part lies. On by default. It is drawn on every sheet with room beside the title block, which is every sheet except A4 portrait. It is not to scale and carries no dimensions.","title":"Sheet Pictogram","type":"boolean"},"stamp_sentence":{"default":true,"description":"The note sentence in the title block's lowest row (\"All dimensions to be verified on site.\" in the drawing's language, or the customer's own wording in stamp.disclaimer). On by default; off leaves the row out of the title block.","title":"Stamp Sentence","type":"boolean"},"text_base_mm":{"default":2.5,"enum":[1.8,2.5,3.5,5.0,7.0,10.0],"title":"Text Base Mm","type":"number"},"font_family":{"default":"DejaVu Sans","enum":["DejaVu Sans","Liberation Sans","Liberation Serif","Liberation Mono"],"title":"Font Family","type":"string"},"decimal_separator":{"default":"auto","description":"The decimal mark of measured numbers: 'auto' follows the drawing language (German comma, English point), 'comma' or 'point' force it. The schema default is the core's own 'auto'.","enum":["auto","comma","point"],"title":"Decimal Separator","type":"string"},"dimension_placement":{"default":"outside","description":"Where the locating dimensions sit: 'outside' (the default) keeps them off the part, clear of its linework; 'on_face' seats them on the face they measure. The schema default is the core's own 'outside', so a request that never names it renders exactly what it rendered before.","enum":["outside","on_face"],"title":"Dimension Placement","type":"string"},"width_edges_mm":{"default":0.5,"maximum":2.0,"minimum":0.05,"title":"Width Edges Mm","type":"number"},"width_furniture_mm":{"default":0.25,"maximum":2.0,"minimum":0.05,"title":"Width Furniture Mm","type":"number"},"width_stamp_mm":{"default":0.35,"maximum":2.0,"minimum":0.05,"title":"Width Stamp Mm","type":"number"},"output_format":{"default":"both","enum":["dxf","pdf","svg","both","all"],"title":"Output Format","type":"string"},"file_production":{"default":"automatic","description":"When this batch's DXF and PDF files are produced. 'automatic' (the default, and what every request written before this field meant) makes them as soon as each part is drawn. 'on_request' stops after the previews so you can show your own customer the drawings first, and you then ask for the files with POST /v1/jobs/{id}/files. Nothing is billed either way until the archive is fetched. Leaving the printed check notice off is only possible through the second shape, because the declaration it needs is about drawings somebody has already seen.","enum":["automatic","on_request"],"title":"File Production","type":"string"},"merge_identical_parts":{"default":true,"description":"Draw this batch's identical parts on one sheet. ON by default. Two uploaded solids are the same part only when their MEASURED geometry is identical to within one micron; a name is not a measurement. Never across jobs. The group is drawn once and its sheet's title block carries the count and every member's position number. Whatever this setting says, identical parts, and a part and its mirror image, cost one unit together when you download the job; see `counted_with` on each part. Every uploaded solid is still listed and still answered for. Send false to have every solid drawn on a sheet of its own.","title":"Merge Identical Parts","type":"boolean"},"paper_allowed":{"default":[],"description":"The sheets automatic paper selection may use, all of one family. Empty (the default) means just paper_name, which is what a request that never named this field has always got. Order does not matter — the set is walked smallest first, and the smallest sheet the part reads on legibly wins. The set also decides where the climb starts: naming it without naming paper_name moves paper_name to the set's smallest sheet, so an allowed set of the US family is drawn on US paper and not on the ISO default.","items":{"enum":["A4","A3","A2","A1","A0","ANSI A","ANSI B","ANSI C","ANSI D","ANSI E"]},"title":"Paper Allowed","type":"array"},"scales_allowed":{"default":[],"description":"The scale rungs automatic scale selection may use, as denominators (5 means 1:5). Empty (the default) means the whole ladder, which is what a request that never named this field has always got. The set bounds the automatic choice only: a fixed scale_denominator is drawn whether or not it is in the set, and a non-ISO rung in the set acts only while non_iso_scales is on. The enlargements are named as the scale they are, \"2:1\" and \"5:1\": a list that names neither allows both, and \"1:1\" alone among them allows no enlargement.","items":{"enum":[1,2,3,4,5,10,15,20,25,30,50,100,"5:1","2:1","1:1"]},"title":"Scales Allowed","type":"array"},"respect_part_names":{"default":false,"description":"Keep identically shaped solids apart when the file calls them different things. OFF by default: a name is not a measurement, so two solids of one shape are one part however the CAD file labelled them. With this on, the solid's own name from the STEP file joins the comparison and only same-shape, same-name solids are merged. No effect when merge_identical_parts is false.","title":"Respect Part Names","type":"boolean"},"stamp":{"$ref":"#/$defs/StampFieldsV1"}},"title":"DrawSettingsV1","type":"object"},"retired":{"combined_dxf":"accepted by name, ignored, never stored","merged_pdf":"accepted by name, ignored, never stored"}}