Lines Matching +full:3 +full:- +full:bit
31 .Nd fixed-point math library based on the
39 data types and APIs support fixed-point math based on the
79 None of the operations is affected by the floating-point environment.
86 .Bl -column "isgreaterequal" "bessel function of the second kind of the order 0"
91 .Xr Q_INI 3 initialise a Q number
95 .Xr Q_QADDQ 3 addition
96 .Xr Q_QDIVQ 3 division
97 .Xr Q_QMULQ 3 multiplication
98 .Xr Q_QSUBQ 3 subtraction
99 .Xr Q_NORMPREC 3 normalisation
100 .Xr Q_QMAXQ 3 maximum function
101 .Xr Q_QMINQ 3 minimum function
102 .Xr Q_QCLONEQ 3 identical copy
103 .Xr Q_QCPYVALQ 3 representational copy
107 .Xr Q_QADDI 3 addition
108 .Xr Q_QDIVI 3 division
109 .Xr Q_QMULI 3 multiplication
110 .Xr Q_QSUBI 3 subtraction
111 .Xr Q_QFRACI 3 fraction
112 .Xr Q_QCPYVALI 3 overwrite
116 .Xr Q_QABS 3 absolute value
117 .Xr Q_Q2D 3 double representation
118 .Xr Q_Q2F 3 float representation
122 .Xr Q_SIGNED 3 determine sign
123 .Xr Q_LTZ 3 less than zero
124 .Xr Q_PRECEQ 3 compare bits
125 .Xr Q_QLTQ 3 less than
126 .Xr Q_QLEQ 3 less or equal
127 .Xr Q_QGTQ 3 greater than
128 .Xr Q_QGEQ 3 greater or equal
129 .Xr Q_QEQ 3 equal
130 .Xr Q_QNEQ 3 not equal
131 .Xr Q_OFLOW 3 would overflow
132 .Xr Q_RELPREC 3 relative precision
136 .Xr Q_SIGNSHFT 3 sign bit position
137 .Xr Q_SSIGN 3 sign bit
138 .Xr Q_CRAWMASK 3 control bitmask
139 .Xr Q_SRAWMASK 3 sign bitmask
140 .Xr Q_GCRAW 3 raw control bits
141 .Xr Q_GCVAL 3 value of control bits
142 .Xr Q_SCVAL 3 set control bits
146 .Xr Q_IFRAWMASK 3 integer/fractional bitmask
147 .Xr Q_IFVALIMASK 3 value of integer bits
148 .Xr Q_IFVALFMASK 3 value of fractional bits
149 .Xr Q_GIFRAW 3 raw integer/fractional bits
150 .Xr Q_GIFABSVAL 3 absolute value of fractional bits
151 .Xr Q_GIFVAL 3 real value of fractional bits
152 .Xr Q_SIFVAL 3 set integer/fractional bits
153 .Xr Q_SIFVALS 3 set separate integer/fractional values
157 .Xr Q_IRAWMASK 3 integer bitmask
158 .Xr Q_GIRAW 3 raw integer bits
159 .Xr Q_GIABSVAL 3 absolute value of integer bits
160 .Xr Q_GIVAL 3 real value of integer bits
161 .Xr Q_SIVAL 3 set integer bits
165 .Xr Q_FRAWMASK 3 fractional bitmask
166 .Xr Q_GFRAW 3 raw fractional bits
167 .Xr Q_GFABSVAL 3 absolute value of fractional bits
168 .Xr Q_GFVAL 3 real value of fractional bits
169 .Xr Q_SFVAL 3 set fractional bits
173 .Xr Q_NCBITS 3 number of reserved control bits
174 .Xr Q_BT 3 C data type
175 .Xr Q_TC 3 casted data type
176 .Xr Q_NTBITS 3 number of total bits
177 .Xr Q_NFCBITS 3 number of control-encoded fractional bits
178 .Xr Q_MAXNFBITS 3 number of maximum fractional bits
179 .Xr Q_NFBITS 3 number of effective fractional bits
180 .Xr Q_NIBITS 3 number of integer bits
181 .Xr Q_RPSHFT 3 bit position of radix point
182 .Xr Q_ABS 3 absolute value
183 .Xr Q_MAXSTRLEN 3 number of characters to render string
184 .Xr Q_TOSTR 3 render string
185 .Xr Q_SHL 3 left-shifted value
186 .Xr Q_SHR 3 right-shifted value
187 .Xr Q_DEBUG 3 render debugging information
188 .Xr Q_DFV2BFV 3 convert decimal fractional value
193 data types and APIs support fixed-point math based on the
201 .Pq excluding the sign bit for signed types ,
207 .Bd -literal -offset indent
231 The 3 least significant bits
234 .Bl -dash
236 bits 1-2 specify the binary radix point shift index operand, with 00,01,10,11 ==
237 1,2,3,4.
239 bit 3 specifies the radix point shift index operand multiplier as 2
252 Additionally, the most significant bit
254 of signed Q types stores the sign bit, with bit value 0 representing a positive
255 number and bit value 1 representing a negative number.
256 Negative numbers are stored as absolute values with the sign bit set, rather
258 This avoids having to bit shift negative numbers, which can result in undefined
262 distinct data bit types and associated bit counts.
263 Data bit types/labels, listed in LSB to MSB order, are: control
273 .Bd -literal -offset indent
278 3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1
279 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
284 Important bit counts are: total, control, control-encoded fractional, maximum
290 The count of control-encoded fractional bits is derived from calculating the
291 number of fractional bits per the control bit encoding scheme.
292 For example, the control bits binary value of 101 encodes a fractional bit
297 For example, a s32q_t has a maximum of 32 - 3 - 1 = 28 fractional bits.
300 control-encoded fractional bits and the maximum fractional bits.
301 For example, a s32q_t with 32 control-encoded fractional bits is effectively
305 total bits and all other non-integer data bits
307 For example, a s32q_t with 8 effective fractional bits has 32 - 3 - 8 - 1 = 20 integer
310 been reserved for fractional data, e.g., when the number of control-encoded
315 .Bd -literal -offset indent
320 Q_INI(&pi, 3, 14159, 16);
327 Q_TOSTR(a, -1, 10, buf, sizeof(buf));
333 initialise it with the fixed-point value for 5/3, and render a debugging
335 .Pq including its full precision decimal C-string representation ,
337 .Bd -literal -offset indent
340 Q_QFRACI(&s32, 5, 3);
342 Q_TOSTR(s32, -1, 10, buf, sizeof(buf));
347 .Bd -literal -offset indent
365 .Xr math 3 ,
366 .Xr Q_FRAWMASK 3 ,
367 .Xr Q_IFRAWMASK 3 ,
368 .Xr Q_INI 3 ,
369 .Xr Q_IRAWMASK 3 ,
370 .Xr Q_QABS 3 ,
371 .Xr Q_QADDI 3 ,
372 .Xr Q_QADDQ 3 ,
373 .Xr Q_SIGNED 3 ,
374 .Xr Q_SIGNSHFT 3 ,
382 .An -nosplit