tiny.zen.AsciiRenderPlan

1/// Exact, clamped storage demand for one document and option set.2pub const Plan = struct {3    /// Admitted width after clamping.4    width: usize,5    /// Admitted height after clamping.6    height: usize,7    /// Categorical bound slots required by the document.8    categories: usize,9    /// Stacked-series total slots required by the document.10    stack_totals: usize,11    /// Exact canvas bytes required.12    canvas_bytes: usize,13    /// Maximum output bytes required before row compaction.14    output_bytes: usize,1516    /// Measures document scratch and clamps dimensions without allocating.17    pub fn inspect(18        document: *const diagram.Document,19        options: model.Options,20    ) error{CapacityOverflow}!Plan {21        const width = clamp(options.width, 24, 200);22        const height = clamp(options.height, 8, 80);23        const scratch = diagram.bounds.ScratchPlan.inspect(document);24        return .{25            .width = width,26            .height = height,27            .categories = scratch.categories,28            .stack_totals = scratch.stack_totals,29            .canvas_bytes = try multiplied(width, height),30            .output_bytes = try multiplied(try added(width, 1), height),31        };32    }3334    /// Returns the smallest limits that admit this render.35    pub fn exactLimits(self: Plan) Limits {36        return .{37            .max_categories = self.categories,38            .max_stack_totals = self.stack_totals,39            .max_canvas_bytes = self.canvas_bytes,40            .max_output_bytes = self.output_bytes,41        };42    }4344    /// Rejects when any measured region exceeds supplied limits.45    pub fn require(self: Plan, limits: Limits) model.Exhaustion!void {46        if (self.categories > limits.max_categories) {47            return error.AsciiCategoryCapacityExceeded;48        }49        if (self.stack_totals > limits.max_stack_totals) {50            return error.AsciiStackTotalCapacityExceeded;51        }52        if (self.canvas_bytes > limits.max_canvas_bytes) {53            return error.AsciiCanvasByteCapacityExceeded;54        }55        if (self.output_bytes > limits.max_output_bytes) {56            return error.AsciiOutputByteCapacityExceeded;57        }58    }59};

1/// Exact, clamped ASCII demand for one document and option set.2pub const AsciiRenderPlan = diagram.AsciiRenderPlan;