From e0d82ec20187d3fc22f739b257537dcbbeb8af66 Mon Sep 17 00:00:00 2001 From: Willem Date: Tue, 16 Sep 2025 12:00:19 +0200 Subject: [PATCH] FC18: Some javadoc and added universal ranged space cake slice idea --- .../fc18/zion7/FourCornerZion7AlphaOmega.java | 4 ++- .../fc18/zion7/FourCornerZion7BaseVoid.java | 2 +- .../fc18/zion7/FourCornerZion7Bereshit.java | 26 ++++++++++++------- .../fc18/zion7/FourCornerZion7Candlelier.java | 12 ++++----- 4 files changed, 27 insertions(+), 17 deletions(-) diff --git a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7AlphaOmega.java b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7AlphaOmega.java index 1add7a1..45eaee9 100644 --- a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7AlphaOmega.java +++ b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7AlphaOmega.java @@ -22,14 +22,16 @@ */ package org.x4o.fc18.zion7; -/// Handles the lexer document mode begin and end strobes. +/// Handles the document the begin and the end strobes. /// /// @author Willem Cazander /// @version 1.0 Jan 11, 2025 public interface FourCornerZion7AlphaOmega { + /// The beginning void strobeDocumentAlpha(); + /// The ending void strobeDocumentOmega(); interface Adapter extends FourCornerZion7AlphaOmega { diff --git a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7BaseVoid.java b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7BaseVoid.java index 9a2117b..be6d9a1 100644 --- a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7BaseVoid.java +++ b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7BaseVoid.java @@ -34,7 +34,7 @@ import org.x4o.fc18.octal8.PrimordialOctal; /// @version 1.0 Sep 8, 2025 public interface FourCornerZion7BaseVoid extends FourCornerZion7AlphaOmega { - /// Embed sand spice using a sand walk to call the identified great sand worm which leaves the spice in the sand. + /// An embedded sand worm, with a sand walk to call the sand worm which leaves the spice in the sand. void strobeSandWorm(List sandWalk, List sandSpice); interface Adapter extends FourCornerZion7BaseVoid, FourCornerZion7AlphaOmega.Adapter { diff --git a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Bereshit.java b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Bereshit.java index d78719a..22c8c06 100644 --- a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Bereshit.java +++ b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Bereshit.java @@ -33,34 +33,42 @@ import org.x4o.fc18.zion7.flame4.FCFlameNumberTaste; import org.x4o.fc18.zion7.flame4.FCFlameSalahSequence; import org.x4o.fc18.zion7.flame4.FCFlameWordDish; -/// Handles the main four corner cake strobes. +/// Handles the basic four corner cake strobes. /// /// @author Willem Cazander /// @version 1.0 Jan 09, 2025 public interface FourCornerZion7Bereshit extends FourCornerZion7BaseVoid { - /// Single word cake point. + /// An single word cake point. void strobeTheWord(FCFlameWordDish course, int cakePoint); - /// Block of word cake points. + /// An block of word cake points. void strobeTheWords(FCFlameWordDish course, List cakePoints); - //void strobeStructSpacePastor(); + // all space is relative of the 100% "user defined" single space glyph from unicode/uni4D + // 100% = normal space = 0x20 ascii + // 400% = tab space = 0x09 ascii + // 0% = empty space = joiner + // TODO no-break(=all-odd?) vs form-hyphen(=F4) vs soft-hyphen(=F4) + // An structural space pastor, as basic word separator feature. + //void strobeStructSpacePastor(int percentage); + + // An structural nun line, as basic document grouping feature. //void strobeStructNunLine(); - /// Embed base2 computer lego number. + /// An base2 computer lego number. void strobeNumberBASE2Lego(FCFlameFremanLegoBase2 type, BigInteger value); - /// Embed base2 computer integer number. + /// An base2 computer signed number. void strobeNumberBASE2Signed(FCFlameFremanSignedBase2 type, boolean sign, BigInteger value); - /// Embed base8 computer lego number. + /// An base8 computer lego number. void strobeNumberBASE8Lego(FCFlameFremanLegoBase8 type, BigInteger value); - /// Embed base8 computer chocolate number. + /// An base8 computer chocolate number. void strobeNumberBASE8Choco(FCFlameFremanChocoBase8 type, FCFlameNumberTaste taste, BigInteger value); - /// The external supported salah sequence strobes. + /// An external salah escape sequence. void strobeSalahSequence(FCFlameSalahSequence type, List> arguments); interface Adapter extends FourCornerZion7Bereshit, FourCornerZion7BaseVoid.Adapter { diff --git a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Candlelier.java b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Candlelier.java index 8019c74..7dd7103 100644 --- a/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Candlelier.java +++ b/nx01-x4o-fc18/src/main/java/org/x4o/fc18/zion7/FourCornerZion7Candlelier.java @@ -28,7 +28,7 @@ import java.util.List; import org.x4o.fc18.zion7.flame4.FCFlameNumberTaste; import org.x4o.fc18.zion7.flame4.FCFlameNumberGram; -/// Handles the embedded numbers in four corner cake strobes. +/// Handles heavy and bigger numbers in four corner cake strobes. /// /// NOTE: "Big" is unlimited, thus "Pig" weight is 2304 bits or 768 octals. /// @@ -36,19 +36,19 @@ import org.x4o.fc18.zion7.flame4.FCFlameNumberGram; /// @version 1.0 Jan 09, 2025 public interface FourCornerZion7Candlelier extends FourCornerZion7Bereshit { - /// Embed one or more number grams of the given supported base degree type. + /// An set of number grams of the give base degree type. void strobeNumberGrams(FCFlameNumberGram gram, List values); - /// Embed choco pig rational number. (4+1148+4+1148) + /// An choco pig rational number. (4+1148+4+1148) void strobeNumberChocoPigRational(FCFlameNumberTaste tasteMale, FCFlameNumberTaste tasteFemale, BigInteger numerator, BigInteger denominator); - /// Embed choco pig decimal point number. (4+1+283+2016) + /// An choco pig decimal point number. (4+1+283+2016) void strobeNumberChocoPigDecimal(FCFlameNumberTaste taste, boolean bias, BigInteger power, BigInteger coefficient); - /// Embed choco pig floating point number. (4+1+283+2016) + /// An choco pig floating point number. (4+1+283+2016) void strobeNumberChocoPigFloat(FCFlameNumberTaste taste, boolean bias, BigInteger exponent, BigInteger mantissa); - /// Embed choped pig point number. (4+1148+1152) + /// An choped pig point number. (4+1148+1152) void strobeNumberChocoPigChoped(FCFlameNumberTaste taste, BigInteger quake, BigInteger fraction); // XDBX18: doom.wad uses (ARM) Q16.16 which is equal to the real (Texas) Q15.16 (because doom map like E2M3 = 6 bit float)