emf 0.2.0-x86_64-darwin

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE.txt +24 -0
  3. data/README.adoc +341 -0
  4. data/exe/emf +125 -0
  5. data/lib/emf/backend.rb +60 -0
  6. data/lib/emf/binary/class_field_accessors.rb +49 -0
  7. data/lib/emf/binary/codec.rb +19 -0
  8. data/lib/emf/binary/float32_le.rb +54 -0
  9. data/lib/emf/binary/types.rb +139 -0
  10. data/lib/emf/binary.rb +10 -0
  11. data/lib/emf/conformance/context.rb +36 -0
  12. data/lib/emf/conformance/diagnostic.rb +18 -0
  13. data/lib/emf/conformance/manifest/emf_bitmap_misc.yml +622 -0
  14. data/lib/emf/conformance/manifest/emf_control_buffers.yml +61 -0
  15. data/lib/emf/conformance/manifest/emf_core.yml +117 -0
  16. data/lib/emf/conformance/manifest/emf_corpus_rules.yml +21 -0
  17. data/lib/emf/conformance/manifest/emf_objects_geometry.yml +229 -0
  18. data/lib/emf/conformance/manifest/emf_plus.yml +357 -0
  19. data/lib/emf/conformance/manifest/emf_plus_core.yml +33 -0
  20. data/lib/emf/conformance/manifest/emf_state_path.yml +403 -0
  21. data/lib/emf/conformance/manifest/emf_text.yml +97 -0
  22. data/lib/emf/conformance/manifest/wmf.yml +874 -0
  23. data/lib/emf/conformance/manifest.rb +79 -0
  24. data/lib/emf/conformance/profile.rb +35 -0
  25. data/lib/emf/conformance/record_types.rb +24 -0
  26. data/lib/emf/conformance/registry.rb +76 -0
  27. data/lib/emf/conformance/report.rb +83 -0
  28. data/lib/emf/conformance/rule.rb +16 -0
  29. data/lib/emf/conformance/rules/emf_bitmap.rb +357 -0
  30. data/lib/emf/conformance/rules/emf_comment_escape.rb +309 -0
  31. data/lib/emf/conformance/rules/emf_control_buffers.rb +137 -0
  32. data/lib/emf/conformance/rules/emf_corpus_named.rb +83 -0
  33. data/lib/emf/conformance/rules/emf_framing.rb +94 -0
  34. data/lib/emf/conformance/rules/emf_geometry.rb +282 -0
  35. data/lib/emf/conformance/rules/emf_header.rb +114 -0
  36. data/lib/emf/conformance/rules/emf_objects.rb +291 -0
  37. data/lib/emf/conformance/rules/emf_parse_recovery.rb +97 -0
  38. data/lib/emf/conformance/rules/emf_path_clip.rb +165 -0
  39. data/lib/emf/conformance/rules/emf_plus.rb +75 -0
  40. data/lib/emf/conformance/rules/emf_plus_common.rb +58 -0
  41. data/lib/emf/conformance/rules/emf_plus_drawing.rb +78 -0
  42. data/lib/emf/conformance/rules/emf_plus_effects.rb +104 -0
  43. data/lib/emf/conformance/rules/emf_plus_fields.rb +169 -0
  44. data/lib/emf/conformance/rules/emf_plus_fields_b.rb +102 -0
  45. data/lib/emf/conformance/rules/emf_plus_framing.rb +172 -0
  46. data/lib/emf/conformance/rules/emf_plus_objects.rb +97 -0
  47. data/lib/emf/conformance/rules/emf_plus_payloads.rb +320 -0
  48. data/lib/emf/conformance/rules/emf_plus_properties.rb +96 -0
  49. data/lib/emf/conformance/rules/emf_plus_state.rb +77 -0
  50. data/lib/emf/conformance/rules/emf_state.rb +244 -0
  51. data/lib/emf/conformance/rules/emf_text.rb +221 -0
  52. data/lib/emf/conformance/rules/emf_transform.rb +85 -0
  53. data/lib/emf/conformance/rules/wmf_buffers.rb +259 -0
  54. data/lib/emf/conformance/rules/wmf_framing.rb +146 -0
  55. data/lib/emf/conformance/rules/wmf_layout_records.rb +112 -0
  56. data/lib/emf/conformance/rules/wmf_objects.rb +168 -0
  57. data/lib/emf/conformance/rules/wmf_records.rb +191 -0
  58. data/lib/emf/conformance/rules/wmf_rejections.rb +184 -0
  59. data/lib/emf/conformance/runner.rb +61 -0
  60. data/lib/emf/conformance/ternary_raster_operations.rb +52 -0
  61. data/lib/emf/conformance.rb +31 -0
  62. data/lib/emf/detector.rb +58 -0
  63. data/lib/emf/emf_plus/binary.rb +8 -0
  64. data/lib/emf/emf_plus/effects/blur.rb +24 -0
  65. data/lib/emf/emf_plus/effects/brightness_contrast.rb +22 -0
  66. data/lib/emf/emf_plus/effects/color_balance.rb +24 -0
  67. data/lib/emf/emf_plus/effects/color_curve.rb +24 -0
  68. data/lib/emf/emf_plus/effects/color_lookup_table.rb +26 -0
  69. data/lib/emf/emf_plus/effects/color_matrix.rb +23 -0
  70. data/lib/emf/emf_plus/effects/effect.rb +50 -0
  71. data/lib/emf/emf_plus/effects/hue_saturation_lightness.rb +24 -0
  72. data/lib/emf/emf_plus/effects/levels.rb +24 -0
  73. data/lib/emf/emf_plus/effects/opaque.rb +19 -0
  74. data/lib/emf/emf_plus/effects/red_eye_correction.rb +35 -0
  75. data/lib/emf/emf_plus/effects/sharpen.rb +24 -0
  76. data/lib/emf/emf_plus/effects/tint.rb +22 -0
  77. data/lib/emf/emf_plus/effects.rb +45 -0
  78. data/lib/emf/emf_plus/frame.rb +41 -0
  79. data/lib/emf/emf_plus/links/effect_link.rb +16 -0
  80. data/lib/emf/emf_plus/links/get_dc_span.rb +18 -0
  81. data/lib/emf/emf_plus/links/link_error.rb +15 -0
  82. data/lib/emf/emf_plus/links.rb +77 -0
  83. data/lib/emf/emf_plus/object_chain.rb +108 -0
  84. data/lib/emf/emf_plus/object_table.rb +182 -0
  85. data/lib/emf/emf_plus/objects/brush.rb +296 -0
  86. data/lib/emf/emf_plus/objects/custom_line_cap.rb +106 -0
  87. data/lib/emf/emf_plus/objects/font.rb +47 -0
  88. data/lib/emf/emf_plus/objects/image.rb +68 -0
  89. data/lib/emf/emf_plus/objects/image_attributes.rb +28 -0
  90. data/lib/emf/emf_plus/objects/opaque.rb +19 -0
  91. data/lib/emf/emf_plus/objects/parts.rb +103 -0
  92. data/lib/emf/emf_plus/objects/path.rb +21 -0
  93. data/lib/emf/emf_plus/objects/pen.rb +132 -0
  94. data/lib/emf/emf_plus/objects/region.rb +39 -0
  95. data/lib/emf/emf_plus/objects/string_format.rb +55 -0
  96. data/lib/emf/emf_plus/objects/typed.rb +50 -0
  97. data/lib/emf/emf_plus/objects.rb +46 -0
  98. data/lib/emf/emf_plus/parser.rb +75 -0
  99. data/lib/emf/emf_plus/records/base.rb +107 -0
  100. data/lib/emf/emf_plus/records/begin_container.rb +31 -0
  101. data/lib/emf/emf_plus/records/begin_container_no_params.rb +20 -0
  102. data/lib/emf/emf_plus/records/body.rb +16 -0
  103. data/lib/emf/emf_plus/records/clear.rb +22 -0
  104. data/lib/emf/emf_plus/records/clip_transform_flags.rb +26 -0
  105. data/lib/emf/emf_plus/records/comment.rb +21 -0
  106. data/lib/emf/emf_plus/records/draw_arc.rb +33 -0
  107. data/lib/emf/emf_plus/records/draw_beziers.rb +31 -0
  108. data/lib/emf/emf_plus/records/draw_closed_curve.rb +34 -0
  109. data/lib/emf/emf_plus/records/draw_curve.rb +38 -0
  110. data/lib/emf/emf_plus/records/draw_driver_string.rb +61 -0
  111. data/lib/emf/emf_plus/records/draw_ellipse.rb +28 -0
  112. data/lib/emf/emf_plus/records/draw_image.rb +42 -0
  113. data/lib/emf/emf_plus/records/draw_image_points.rb +62 -0
  114. data/lib/emf/emf_plus/records/draw_lines.rb +34 -0
  115. data/lib/emf/emf_plus/records/draw_path.rb +23 -0
  116. data/lib/emf/emf_plus/records/draw_pie.rb +33 -0
  117. data/lib/emf/emf_plus/records/draw_rects.rb +30 -0
  118. data/lib/emf/emf_plus/records/draw_string.rb +41 -0
  119. data/lib/emf/emf_plus/records/end_container.rb +20 -0
  120. data/lib/emf/emf_plus/records/end_of_file.rb +17 -0
  121. data/lib/emf/emf_plus/records/fill_brush.rb +21 -0
  122. data/lib/emf/emf_plus/records/fill_closed_curve.rb +38 -0
  123. data/lib/emf/emf_plus/records/fill_ellipse.rb +29 -0
  124. data/lib/emf/emf_plus/records/fill_path.rb +23 -0
  125. data/lib/emf/emf_plus/records/fill_pie.rb +34 -0
  126. data/lib/emf/emf_plus/records/fill_polygon.rb +32 -0
  127. data/lib/emf/emf_plus/records/fill_rects.rb +31 -0
  128. data/lib/emf/emf_plus/records/fill_region.rb +23 -0
  129. data/lib/emf/emf_plus/records/get_dc.rb +18 -0
  130. data/lib/emf/emf_plus/records/header.rb +35 -0
  131. data/lib/emf/emf_plus/records/multiply_world_transform.rb +24 -0
  132. data/lib/emf/emf_plus/records/object.rb +32 -0
  133. data/lib/emf/emf_plus/records/offset_clip.rb +24 -0
  134. data/lib/emf/emf_plus/records/primitives/argb.rb +20 -0
  135. data/lib/emf/emf_plus/records/primitives/bitmap.rb +32 -0
  136. data/lib/emf/emf_plus/records/primitives/bitmap_data.rb +21 -0
  137. data/lib/emf/emf_plus/records/primitives/blend_colors.rb +22 -0
  138. data/lib/emf/emf_plus/records/primitives/blend_factors.rb +21 -0
  139. data/lib/emf/emf_plus/records/primitives/bounded_array.rb +38 -0
  140. data/lib/emf/emf_plus/records/primitives/byte_reader.rb +25 -0
  141. data/lib/emf/emf_plus/records/primitives/character_range.rb +20 -0
  142. data/lib/emf/emf_plus/records/primitives/compressed_image.rb +17 -0
  143. data/lib/emf/emf_plus/records/primitives/focus_scale_data.rb +20 -0
  144. data/lib/emf/emf_plus/records/primitives/graphics_version.rb +21 -0
  145. data/lib/emf/emf_plus/records/primitives/language_identifier.rb +22 -0
  146. data/lib/emf/emf_plus/records/primitives/metafile.rb +19 -0
  147. data/lib/emf/emf_plus/records/primitives/palette.rb +21 -0
  148. data/lib/emf/emf_plus/records/primitives/path.rb +89 -0
  149. data/lib/emf/emf_plus/records/primitives/path_point_type.rb +21 -0
  150. data/lib/emf/emf_plus/records/primitives/path_point_type_rle.rb +23 -0
  151. data/lib/emf/emf_plus/records/primitives/point.rb +18 -0
  152. data/lib/emf/emf_plus/records/primitives/point_array.rb +42 -0
  153. data/lib/emf/emf_plus/records/primitives/point_f.rb +19 -0
  154. data/lib/emf/emf_plus/records/primitives/point_r.rb +19 -0
  155. data/lib/emf/emf_plus/records/primitives/rect.rb +20 -0
  156. data/lib/emf/emf_plus/records/primitives/rect_array.rb +24 -0
  157. data/lib/emf/emf_plus/records/primitives/rect_f.rb +21 -0
  158. data/lib/emf/emf_plus/records/primitives/region_node.rb +68 -0
  159. data/lib/emf/emf_plus/records/primitives/region_node_child_nodes.rb +22 -0
  160. data/lib/emf/emf_plus/records/primitives/region_node_path.rb +37 -0
  161. data/lib/emf/emf_plus/records/primitives/relative_coordinate.rb +32 -0
  162. data/lib/emf/emf_plus/records/primitives/string_format_data.rb +23 -0
  163. data/lib/emf/emf_plus/records/primitives/transform_matrix.rb +23 -0
  164. data/lib/emf/emf_plus/records/primitives.rb +41 -0
  165. data/lib/emf/emf_plus/records/reset_clip.rb +17 -0
  166. data/lib/emf/emf_plus/records/reset_world_transform.rb +17 -0
  167. data/lib/emf/emf_plus/records/restore.rb +20 -0
  168. data/lib/emf/emf_plus/records/rotate_world_transform.rb +24 -0
  169. data/lib/emf/emf_plus/records/save.rb +20 -0
  170. data/lib/emf/emf_plus/records/scale_world_transform.rb +26 -0
  171. data/lib/emf/emf_plus/records/serializable_object.rb +32 -0
  172. data/lib/emf/emf_plus/records/set_anti_alias_mode.rb +25 -0
  173. data/lib/emf/emf_plus/records/set_clip_path.rb +20 -0
  174. data/lib/emf/emf_plus/records/set_clip_rect.rb +24 -0
  175. data/lib/emf/emf_plus/records/set_clip_region.rb +20 -0
  176. data/lib/emf/emf_plus/records/set_compositing_mode.rb +21 -0
  177. data/lib/emf/emf_plus/records/set_compositing_quality.rb +21 -0
  178. data/lib/emf/emf_plus/records/set_interpolation_mode.rb +21 -0
  179. data/lib/emf/emf_plus/records/set_page_transform.rb +25 -0
  180. data/lib/emf/emf_plus/records/set_pixel_offset_mode.rb +21 -0
  181. data/lib/emf/emf_plus/records/set_rendering_origin.rb +22 -0
  182. data/lib/emf/emf_plus/records/set_text_contrast.rb +24 -0
  183. data/lib/emf/emf_plus/records/set_text_rendering_hint.rb +21 -0
  184. data/lib/emf/emf_plus/records/set_ts_clip.rb +40 -0
  185. data/lib/emf/emf_plus/records/set_ts_graphics.rb +88 -0
  186. data/lib/emf/emf_plus/records/set_world_transform.rb +22 -0
  187. data/lib/emf/emf_plus/records/shape_flags.rb +23 -0
  188. data/lib/emf/emf_plus/records/translate_world_transform.rb +26 -0
  189. data/lib/emf/emf_plus/records/unknown.rb +20 -0
  190. data/lib/emf/emf_plus/records.rb +107 -0
  191. data/lib/emf/emf_plus/serializer.rb +20 -0
  192. data/lib/emf/emf_plus/stream/conformance.rb +68 -0
  193. data/lib/emf/emf_plus/stream/editor.rb +21 -0
  194. data/lib/emf/emf_plus/stream/emf_gap.rb +20 -0
  195. data/lib/emf/emf_plus/stream/link_index.rb +30 -0
  196. data/lib/emf/emf_plus/stream/rebuild.rb +47 -0
  197. data/lib/emf/emf_plus/stream/record_handle.rb +26 -0
  198. data/lib/emf/emf_plus/stream/segment.rb +70 -0
  199. data/lib/emf/emf_plus/stream.rb +153 -0
  200. data/lib/emf/emf_plus.rb +18 -0
  201. data/lib/emf/emr/binary/dib_header.rb +142 -0
  202. data/lib/emf/emr/binary/ext_text_out_fields.rb +43 -0
  203. data/lib/emf/emr/binary/extended_pen_buffers.rb +23 -0
  204. data/lib/emf/emr/binary/fast_fill.rb +1164 -0
  205. data/lib/emf/emr/binary/font.rb +159 -0
  206. data/lib/emf/emr/binary/header.rb +41 -0
  207. data/lib/emf/emr/binary/lazy_utf16_array.rb +82 -0
  208. data/lib/emf/emr/binary/pack_plan.rb +144 -0
  209. data/lib/emf/emr/binary/pack_plan_check.rb +75 -0
  210. data/lib/emf/emr/binary/pack_plan_exact.rb +130 -0
  211. data/lib/emf/emr/binary/pack_plan_generate.rb +116 -0
  212. data/lib/emf/emr/binary/pack_plan_values.rb +92 -0
  213. data/lib/emf/emr/binary/palette_body.rb +19 -0
  214. data/lib/emf/emr/binary/palette_entry.rb +18 -0
  215. data/lib/emf/emr/binary/record.rb +50 -0
  216. data/lib/emf/emr/binary/records/abort_path.rb +16 -0
  217. data/lib/emf/emr/binary/records/alpha_blend.rb +60 -0
  218. data/lib/emf/emr/binary/records/angle_arc.rb +19 -0
  219. data/lib/emf/emr/binary/records/arc.rb +19 -0
  220. data/lib/emf/emr/binary/records/arc_to.rb +19 -0
  221. data/lib/emf/emr/binary/records/begin_path.rb +16 -0
  222. data/lib/emf/emr/binary/records/bit_blt.rb +51 -0
  223. data/lib/emf/emr/binary/records/chord.rb +19 -0
  224. data/lib/emf/emr/binary/records/close_figure.rb +16 -0
  225. data/lib/emf/emr/binary/records/color_correct_palette.rb +71 -0
  226. data/lib/emf/emr/binary/records/colormatch_to_target_w.rb +92 -0
  227. data/lib/emf/emr/binary/records/comment.rb +20 -0
  228. data/lib/emf/emr/binary/records/create_brush_indirect.rb +20 -0
  229. data/lib/emf/emr/binary/records/create_colorspace.rb +83 -0
  230. data/lib/emf/emr/binary/records/create_colorspace_w.rb +106 -0
  231. data/lib/emf/emr/binary/records/create_dib_pattern_brush_pt.rb +39 -0
  232. data/lib/emf/emr/binary/records/create_font_indirect_w.rb +22 -0
  233. data/lib/emf/emr/binary/records/create_mono_brush.rb +39 -0
  234. data/lib/emf/emr/binary/records/create_palette.rb +35 -0
  235. data/lib/emf/emr/binary/records/create_pen.rb +20 -0
  236. data/lib/emf/emr/binary/records/delete_colorspace.rb +38 -0
  237. data/lib/emf/emr/binary/records/delete_object.rb +16 -0
  238. data/lib/emf/emr/binary/records/draw_escape.rb +61 -0
  239. data/lib/emf/emr/binary/records/ellipse.rb +18 -0
  240. data/lib/emf/emr/binary/records/end_path.rb +16 -0
  241. data/lib/emf/emr/binary/records/eof.rb +30 -0
  242. data/lib/emf/emr/binary/records/exclude_clip_rect.rb +16 -0
  243. data/lib/emf/emr/binary/records/ext_create_pen.rb +96 -0
  244. data/lib/emf/emr/binary/records/ext_escape.rb +61 -0
  245. data/lib/emf/emr/binary/records/ext_flood_fill.rb +24 -0
  246. data/lib/emf/emr/binary/records/ext_select_clip_rgn.rb +27 -0
  247. data/lib/emf/emr/binary/records/ext_text_out_a.rb +40 -0
  248. data/lib/emf/emr/binary/records/ext_text_out_w.rb +52 -0
  249. data/lib/emf/emr/binary/records/fill_path.rb +16 -0
  250. data/lib/emf/emr/binary/records/fill_rgn.rb +26 -0
  251. data/lib/emf/emr/binary/records/flatten_path.rb +16 -0
  252. data/lib/emf/emr/binary/records/force_ufi_mapping.rb +54 -0
  253. data/lib/emf/emr/binary/records/frame_rgn.rb +27 -0
  254. data/lib/emf/emr/binary/records/gls_bounded_record.rb +77 -0
  255. data/lib/emf/emr/binary/records/gls_record.rb +58 -0
  256. data/lib/emf/emr/binary/records/gradient_fill.rb +26 -0
  257. data/lib/emf/emr/binary/records/intersect_clip_rect.rb +16 -0
  258. data/lib/emf/emr/binary/records/invert_rgn.rb +25 -0
  259. data/lib/emf/emr/binary/records/line_to.rb +16 -0
  260. data/lib/emf/emr/binary/records/mask_blt.rb +83 -0
  261. data/lib/emf/emr/binary/records/modify_world_transform.rb +17 -0
  262. data/lib/emf/emr/binary/records/move_to_ex.rb +16 -0
  263. data/lib/emf/emr/binary/records/named_escape.rb +94 -0
  264. data/lib/emf/emr/binary/records/offset_clip_rgn.rb +16 -0
  265. data/lib/emf/emr/binary/records/paint_rgn.rb +25 -0
  266. data/lib/emf/emr/binary/records/pie.rb +19 -0
  267. data/lib/emf/emr/binary/records/pixel_format.rb +92 -0
  268. data/lib/emf/emr/binary/records/plg_blt.rb +83 -0
  269. data/lib/emf/emr/binary/records/poly_bezier.rb +17 -0
  270. data/lib/emf/emr/binary/records/poly_bezier16.rb +17 -0
  271. data/lib/emf/emr/binary/records/poly_bezier_to.rb +17 -0
  272. data/lib/emf/emr/binary/records/poly_bezier_to16.rb +17 -0
  273. data/lib/emf/emr/binary/records/poly_draw.rb +18 -0
  274. data/lib/emf/emr/binary/records/poly_draw16.rb +18 -0
  275. data/lib/emf/emr/binary/records/poly_polygon.rb +19 -0
  276. data/lib/emf/emr/binary/records/poly_polygon16.rb +19 -0
  277. data/lib/emf/emr/binary/records/poly_polyline.rb +19 -0
  278. data/lib/emf/emr/binary/records/poly_polyline16.rb +19 -0
  279. data/lib/emf/emr/binary/records/poly_textout_a.rb +144 -0
  280. data/lib/emf/emr/binary/records/poly_textout_w.rb +144 -0
  281. data/lib/emf/emr/binary/records/polygon.rb +17 -0
  282. data/lib/emf/emr/binary/records/polygon16.rb +17 -0
  283. data/lib/emf/emr/binary/records/polyline.rb +17 -0
  284. data/lib/emf/emr/binary/records/polyline16.rb +17 -0
  285. data/lib/emf/emr/binary/records/polyline_to.rb +17 -0
  286. data/lib/emf/emr/binary/records/polyline_to16.rb +17 -0
  287. data/lib/emf/emr/binary/records/raw.rb +22 -0
  288. data/lib/emf/emr/binary/records/realize_palette.rb +16 -0
  289. data/lib/emf/emr/binary/records/rectangle.rb +18 -0
  290. data/lib/emf/emr/binary/records/resize_palette.rb +31 -0
  291. data/lib/emf/emr/binary/records/restore_dc.rb +17 -0
  292. data/lib/emf/emr/binary/records/round_rect.rb +19 -0
  293. data/lib/emf/emr/binary/records/save_dc.rb +16 -0
  294. data/lib/emf/emr/binary/records/scale_viewport_ext_ex.rb +19 -0
  295. data/lib/emf/emr/binary/records/scale_window_ext_ex.rb +19 -0
  296. data/lib/emf/emr/binary/records/select_clip_path.rb +20 -0
  297. data/lib/emf/emr/binary/records/select_object.rb +16 -0
  298. data/lib/emf/emr/binary/records/select_palette.rb +17 -0
  299. data/lib/emf/emr/binary/records/set_arc_direction.rb +16 -0
  300. data/lib/emf/emr/binary/records/set_bk_color.rb +16 -0
  301. data/lib/emf/emr/binary/records/set_bk_mode.rb +16 -0
  302. data/lib/emf/emr/binary/records/set_brush_org_ex.rb +16 -0
  303. data/lib/emf/emr/binary/records/set_color_adjustment.rb +136 -0
  304. data/lib/emf/emr/binary/records/set_colorspace.rb +38 -0
  305. data/lib/emf/emr/binary/records/set_dibits_to_device.rb +60 -0
  306. data/lib/emf/emr/binary/records/set_icm_mode.rb +16 -0
  307. data/lib/emf/emr/binary/records/set_icm_profile_a.rb +87 -0
  308. data/lib/emf/emr/binary/records/set_icm_profile_w.rb +87 -0
  309. data/lib/emf/emr/binary/records/set_layout.rb +16 -0
  310. data/lib/emf/emr/binary/records/set_linked_ufis.rb +65 -0
  311. data/lib/emf/emr/binary/records/set_map_mode.rb +16 -0
  312. data/lib/emf/emr/binary/records/set_mapper_flags.rb +16 -0
  313. data/lib/emf/emr/binary/records/set_metargn.rb +16 -0
  314. data/lib/emf/emr/binary/records/set_miter_limit.rb +16 -0
  315. data/lib/emf/emr/binary/records/set_palette_entries.rb +35 -0
  316. data/lib/emf/emr/binary/records/set_pixel_v.rb +18 -0
  317. data/lib/emf/emr/binary/records/set_poly_fill_mode.rb +16 -0
  318. data/lib/emf/emr/binary/records/set_rop2.rb +16 -0
  319. data/lib/emf/emr/binary/records/set_stretch_blt_mode.rb +16 -0
  320. data/lib/emf/emr/binary/records/set_text_align.rb +16 -0
  321. data/lib/emf/emr/binary/records/set_text_color.rb +17 -0
  322. data/lib/emf/emr/binary/records/set_text_justification.rb +23 -0
  323. data/lib/emf/emr/binary/records/set_viewport_ext_ex.rb +16 -0
  324. data/lib/emf/emr/binary/records/set_viewport_org_ex.rb +16 -0
  325. data/lib/emf/emr/binary/records/set_window_ext_ex.rb +16 -0
  326. data/lib/emf/emr/binary/records/set_window_org_ex.rb +16 -0
  327. data/lib/emf/emr/binary/records/set_world_transform.rb +16 -0
  328. data/lib/emf/emr/binary/records/small_text_out.rb +79 -0
  329. data/lib/emf/emr/binary/records/stretch_blt.rb +53 -0
  330. data/lib/emf/emr/binary/records/stretch_dibits.rb +56 -0
  331. data/lib/emf/emr/binary/records/stroke_and_fill_path.rb +16 -0
  332. data/lib/emf/emr/binary/records/stroke_path.rb +16 -0
  333. data/lib/emf/emr/binary/records/transparent_blt.rb +60 -0
  334. data/lib/emf/emr/binary/records/widen_path.rb +16 -0
  335. data/lib/emf/emr/binary/records.rb +260 -0
  336. data/lib/emf/emr/binary/region_data.rb +33 -0
  337. data/lib/emf/emr/binary/state_record_body.rb +33 -0
  338. data/lib/emf/emr/binary/thin_shell.rb +226 -0
  339. data/lib/emf/emr/binary/type_codes.rb +132 -0
  340. data/lib/emf/emr/binary/value_view/layout.rb +101 -0
  341. data/lib/emf/emr/binary/value_view/reader_source.rb +88 -0
  342. data/lib/emf/emr/binary/value_view.rb +173 -0
  343. data/lib/emf/emr/binary/variable_buffers.rb +87 -0
  344. data/lib/emf/emr/binary/with_bounds.rb +15 -0
  345. data/lib/emf/emr/binary.rb +17 -0
  346. data/lib/emf/emr/filled_record.rb +77 -0
  347. data/lib/emf/emr/parser.rb +374 -0
  348. data/lib/emf/emr/path_association.rb +16 -0
  349. data/lib/emf/emr/serializer.rb +23 -0
  350. data/lib/emf/emr.rb +11 -0
  351. data/lib/emf/error.rb +42 -0
  352. data/lib/emf/model/diagnostic.rb +41 -0
  353. data/lib/emf/model/emr/header.rb +132 -0
  354. data/lib/emf/model/emr/records.rb +184 -0
  355. data/lib/emf/model/emr/wire_values.rb +43 -0
  356. data/lib/emf/model/emr.rb +11 -0
  357. data/lib/emf/model/geometry/color.rb +85 -0
  358. data/lib/emf/model/geometry/matrix.rb +52 -0
  359. data/lib/emf/model/geometry/point.rb +41 -0
  360. data/lib/emf/model/geometry/point_f.rb +33 -0
  361. data/lib/emf/model/geometry/point_s.rb +33 -0
  362. data/lib/emf/model/geometry/rect.rb +57 -0
  363. data/lib/emf/model/geometry/rect_s.rb +49 -0
  364. data/lib/emf/model/geometry/size.rb +33 -0
  365. data/lib/emf/model/geometry.rb +16 -0
  366. data/lib/emf/model/metafile.rb +54 -0
  367. data/lib/emf/model/record.rb +19 -0
  368. data/lib/emf/model/visitor.rb +42 -0
  369. data/lib/emf/model/wmf/bitmap_records.rb +155 -0
  370. data/lib/emf/model/wmf/brush_records.rb +45 -0
  371. data/lib/emf/model/wmf/dc_escape_records.rb +67 -0
  372. data/lib/emf/model/wmf/font_record.rb +40 -0
  373. data/lib/emf/model/wmf/geometry_records.rb +107 -0
  374. data/lib/emf/model/wmf/header.rb +36 -0
  375. data/lib/emf/model/wmf/object_records.rb +71 -0
  376. data/lib/emf/model/wmf/palette_records.rb +68 -0
  377. data/lib/emf/model/wmf/records.rb +247 -0
  378. data/lib/emf/model/wmf/region_records.rb +112 -0
  379. data/lib/emf/model/wmf/state_records.rb +188 -0
  380. data/lib/emf/model/wmf/text_records.rb +36 -0
  381. data/lib/emf/model/wmf.rb +11 -0
  382. data/lib/emf/model.rb +13 -0
  383. data/lib/emf/native/bitmap_fields.rb +58 -0
  384. data/lib/emf/native/diagnostic_contract.rb +39 -0
  385. data/lib/emf/native/diagnostics.rb +81 -0
  386. data/lib/emf/native/emf_plus_loader.rb +35 -0
  387. data/lib/emf/native/emf_plus_snapshot.rb +96 -0
  388. data/lib/emf/native/emf_plus_source.rb +20 -0
  389. data/lib/emf/native/emf_plus_stream.rb +150 -0
  390. data/lib/emf/native/fields.rb +369 -0
  391. data/lib/emf/native/font_fields.rb +87 -0
  392. data/lib/emf/native/gradient_fields.rb +23 -0
  393. data/lib/emf/native/header.rb +35 -0
  394. data/lib/emf/native/header_errors.rb +30 -0
  395. data/lib/emf/native/hydrator.rb +151 -0
  396. data/lib/emf/native/lazy_wire.rb +100 -0
  397. data/lib/emf/native/legacy_state_fields.rb +22 -0
  398. data/lib/emf/native/library_path.rb +68 -0
  399. data/lib/emf/native/loader.rb +120 -0
  400. data/lib/emf/native/palette_fields.rb +45 -0
  401. data/lib/emf/native/platforms.json +6 -0
  402. data/lib/emf/native/poly_text_fields.rb +116 -0
  403. data/lib/emf/native/provenance.json +11 -0
  404. data/lib/emf/native/resource_failure.rb +28 -0
  405. data/lib/emf/native/small_text_fields.rb +27 -0
  406. data/lib/emf/native/snapshot.rb +102 -0
  407. data/lib/emf/native/wmf_bitmap_fields.rb +58 -0
  408. data/lib/emf/native/wmf_brush_fields.rb +62 -0
  409. data/lib/emf/native/wmf_fields.rb +117 -0
  410. data/lib/emf/native/wmf_hydrator.rb +143 -0
  411. data/lib/emf/native/wmf_loading.rb +49 -0
  412. data/lib/emf/native/wmf_palette_fields.rb +60 -0
  413. data/lib/emf/native/wmf_region_fields.rb +92 -0
  414. data/lib/emf/native/wmf_rejection.rb +84 -0
  415. data/lib/emf/native/wmf_remaining_fields.rb +70 -0
  416. data/lib/emf/native/wmf_snapshot.rb +51 -0
  417. data/lib/emf/native/wmf_text_fields.rb +56 -0
  418. data/lib/emf/native/x86_64-darwin/libemf_ffi.dylib +0 -0
  419. data/lib/emf/native.rb +61 -0
  420. data/lib/emf/parse_evidence.rb +57 -0
  421. data/lib/emf/resource_budget/bitmap.rb +66 -0
  422. data/lib/emf/resource_budget/gradient.rb +30 -0
  423. data/lib/emf/resource_budget/poly_text.rb +85 -0
  424. data/lib/emf/resource_budget.rb +382 -0
  425. data/lib/emf/resource_limits/emf_records.rb +130 -0
  426. data/lib/emf/resource_limits.rb +58 -0
  427. data/lib/emf/version.rb +5 -0
  428. data/lib/emf/visitors/dump.rb +61 -0
  429. data/lib/emf/visitors/stats.rb +64 -0
  430. data/lib/emf/visitors.rb +8 -0
  431. data/lib/emf/wmf/binary.rb +158 -0
  432. data/lib/emf/wmf/bitmap_codec.rb +118 -0
  433. data/lib/emf/wmf/brush_codec.rb +102 -0
  434. data/lib/emf/wmf/dc_escape_codec.rb +75 -0
  435. data/lib/emf/wmf/dib.rb +187 -0
  436. data/lib/emf/wmf/embedded_emf.rb +137 -0
  437. data/lib/emf/wmf/escape_views.rb +89 -0
  438. data/lib/emf/wmf/evidence.rb +255 -0
  439. data/lib/emf/wmf/geometry_codec.rb +49 -0
  440. data/lib/emf/wmf/palette_codec.rb +85 -0
  441. data/lib/emf/wmf/parser.rb +158 -0
  442. data/lib/emf/wmf/recovery.rb +95 -0
  443. data/lib/emf/wmf/region_codec.rb +151 -0
  444. data/lib/emf/wmf/serializer.rb +175 -0
  445. data/lib/emf/wmf/text_codec.rb +123 -0
  446. data/lib/emf/wmf.rb +16 -0
  447. data/lib/emf.rb +60 -0
  448. metadata +520 -0
@@ -0,0 +1,39 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Emf
4
+ module Native
5
+ # Snapshot recovery kinds are provenance, independently of public error text.
6
+ class DiagnosticContract
7
+ def initialize(snapshot, input)
8
+ @snapshot = snapshot
9
+ @input = input
10
+ end
11
+
12
+ def call(metafile)
13
+ return metafile if @snapshot.diagnostics.empty?
14
+
15
+ offsets = @snapshot.table.each_slice(5).map { |entry| entry[1] }
16
+ diagnostics = @snapshot.diagnostics.flat_map do |kind, has_type, type, _reserved, offset|
17
+ index = offsets.bsearch_index { |candidate| candidate >= offset } || offsets.length
18
+ code = has_type == 1 ? type : @input.unpack1("V", offset: offset) || 0
19
+ if kind == Diagnostics::INVALID_PAYLOAD
20
+ recovered_diagnostics(offset, index + 1, code)
21
+ else
22
+ [Model::Diagnostic.new(record_index: index + 1, record_code: code, byte_offset: offset, disposition: :skipped)]
23
+ end
24
+ end
25
+ metafile.with_diagnostics(diagnostics.sort_by(&:byte_offset))
26
+ end
27
+
28
+ private
29
+
30
+ def recovered_diagnostics(offset, index, code)
31
+ return [] if Hydrator::OPAQUE_BODY_TYPES.include?(code)
32
+
33
+ diagnostics = []
34
+ Emr::Parser.read_record_at(@input, offset, [], diagnostics: diagnostics, record_index: index)
35
+ diagnostics
36
+ end
37
+ end
38
+ end
39
+ end
@@ -0,0 +1,81 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "stringio"
4
+
5
+ module Emf
6
+ module Native
7
+ # Turns native snapshot diagnostics into the Ruby parser's ParseErrors.
8
+ #
9
+ # Framing diagnostics (kinds 1-3) carry their numbers, so the Ruby message
10
+ # is rebuilt from them. A kind-4 diagnostic only says that native could not
11
+ # decode a record's payload, not why, and native decodes some bodies Ruby
12
+ # keeps opaque. The Ruby parser is the contract for such a record, so its own
13
+ # per-record reader decides: it accepts the record as typed, or preserves it as
14
+ # Raw with its own message. Record bodies native hydrates as opaque classes are
15
+ # never rejected by Ruby, so their diagnostic is dropped without a Ruby read.
16
+ class Diagnostics
17
+ INVALID_PAYLOAD = 4
18
+ Recovery = Struct.new(:adapter, :errors, :wire)
19
+
20
+ def initialize(snapshot, input)
21
+ @snapshot = snapshot
22
+ @input = input
23
+ @recovered = invalid_payload_offsets.to_h { |offset, type| [offset, recover(offset, type)] }
24
+ end
25
+
26
+ def recovering?
27
+ !@recovered.empty?
28
+ end
29
+
30
+ def recovered?(offset)
31
+ @recovered.key?(offset)
32
+ end
33
+
34
+ def adapter_at(offset)
35
+ @recovered[offset]&.adapter
36
+ end
37
+
38
+ def emf_plus_at(offset)
39
+ wire = @recovered.fetch(offset).wire
40
+ Emr::Parser.extract_emf_plus(wire) if wire.is_a?(Emr::Binary::Records::Comment)
41
+ end
42
+
43
+ def errors
44
+ @snapshot.diagnostics.flat_map do |kind, has_type, type, reserved, offset, detail1, detail2|
45
+ raise FormatError, "invalid native snapshot diagnostic" unless (1..4).cover?(kind) && (0..1).cover?(has_type) && reserved.zero?
46
+ next @recovered.fetch(offset).errors if kind == INVALID_PAYLOAD
47
+
48
+ [ParseError.new(offset: offset, record_code: has_type == 1 ? type : nil, message: message(kind, offset, detail1, detail2))]
49
+ end
50
+ end
51
+
52
+ private
53
+
54
+ def invalid_payload_offsets
55
+ @snapshot.diagnostics.filter_map do |kind, has_type, type, _reserved, offset|
56
+ [offset, has_type == 1 ? type : nil] if kind == INVALID_PAYLOAD
57
+ end
58
+ end
59
+
60
+ def recover(offset, type)
61
+ return Recovery.new(nil, [], nil) if Hydrator::OPAQUE_BODY_TYPES.include?(type)
62
+
63
+ errors = []
64
+ io = StringIO.new(@input)
65
+ io.pos = offset
66
+ wire, suffix = Emr::Parser.read_record(io, offset, errors)
67
+ adapter = Model::Emr::Records::WireAdapter.new(wire: wire, offset: offset, suffix: suffix) if wire
68
+ Recovery.new(adapter, errors, wire)
69
+ end
70
+
71
+ def message(kind, offset, detail1, detail2)
72
+ case kind
73
+ when 1 then "truncated record header at offset #{offset} (#{detail1} bytes)"
74
+ when 2 then "record nSize #{detail1} < 8 bytes (offset #{offset})"
75
+ when 3 then "truncated record at offset #{offset} (claimed #{detail1}, got #{detail2 - 8})"
76
+ else "native parse diagnostic #{kind} at offset #{offset} (#{detail1}, #{detail2})"
77
+ end
78
+ end
79
+ end
80
+ end
81
+ end
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "loader"
4
+
5
+ module Emf
6
+ module Native
7
+ # Adds the independent EMF+ snapshot call (emf_document_emf_plus_snapshot_v1)
8
+ # to the production Loader without touching its outer-snapshot signatures.
9
+ class EmfPlusLoader < Loader
10
+ # Version 2 frames each comment on its own, recovering from malformed framing
11
+ # like the Ruby framer, and types SetTSClip (family 0x106).
12
+ SNAPSHOT_VERSION = 2
13
+ # struct_size, version, max_output_bytes
14
+ DEFAULT_OPTIONS = [16, SNAPSHOT_VERSION, 1 << 30].pack("VVQ<").freeze
15
+
16
+ def initialize(path)
17
+ super
18
+ signature = [POINTER, POINTER, POINTER, POINTER, POINTER]
19
+ @functions[:emf_document_emf_plus_snapshot_v1] = Fiddle::Function.new(
20
+ @library["emf_document_emf_plus_snapshot_v1"], signature, Fiddle::TYPE_INT
21
+ )
22
+ rescue Fiddle::DLError => e
23
+ raise Unavailable, "native EMF+ snapshot could not load: #{e.message}"
24
+ end
25
+
26
+ # The EPSN buffer for the EMF file `bytes`; raises FormatError for malformed
27
+ # nested EMF+ and Error for a resource limit.
28
+ def emf_plus_snapshot(bytes)
29
+ document(bytes.b) do |handle|
30
+ buffer(:emf_document_emf_plus_snapshot_v1, handle, DEFAULT_OPTIONS, 0)
31
+ end
32
+ end
33
+ end
34
+ end
35
+ end
@@ -0,0 +1,96 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Emf
4
+ module Native
5
+ # Reader for the native EMF+ snapshot (EPSN versions 1 and 2, emf-plus-snapshot-v1.md).
6
+ # It validates every length against the buffer, so a truncated or inconsistent
7
+ # snapshot raises FormatError rather than yielding partial data.
8
+ class EmfPlusSnapshot
9
+ HEADER_BYTES = 40
10
+ SEGMENT_BYTES = 32
11
+ FRAME_HEADER_BYTES = 64
12
+ DIAGNOSTIC_BYTES = 24
13
+
14
+ Segment = Struct.new(:record_index, :logical_start, :payload_length, :data_start, keyword_init: true)
15
+ Frame = Struct.new(:index, :offset, :first_segment, :last_segment, :type, :flags, :frame_size, :data_size,
16
+ :family, :raw, :typed, keyword_init: true)
17
+ # kind: :empty_slot, :wrong_type or :object_id_out_of_range (the names of
18
+ # Emf::EmfPlus::ObjectTable diagnostics); role: the required object type.
19
+ Diagnostic = Struct.new(:kind, :object_type, :frame_index, :id, :actual_type, keyword_init: true)
20
+
21
+ KINDS = { 1 => :empty_slot, 2 => :wrong_type, 3 => :object_id_out_of_range }.freeze
22
+ # The family tags of the frame table.
23
+ FAMILIES = { 0 => :opaque, 1 => :header, 2 => :empty, 3 => :clear, 4 => :rendering_origin, 5 => :stack_index,
24
+ 6 => :begin_container, 7 => :matrix, 8 => :pair, 9 => :scalar, 10 => :clip_rect,
25
+ 0x101 => :drawing, 0x102 => :text, 0x103 => :effect, 0x104 => :ts_graphics,
26
+ 0x105 => :object, 0x106 => :ts_clip }.freeze
27
+ VERSIONS = [1, 2].freeze
28
+
29
+ attr_reader :segments, :frames, :diagnostics
30
+
31
+ def initialize(buffer)
32
+ @buffer = buffer.b
33
+ read_header
34
+ @segments = read_segments
35
+ @frames = read_frames
36
+ @diagnostics = read_diagnostics
37
+ raise FormatError, "EMF+ snapshot has trailing bytes" unless @cursor == @buffer.bytesize
38
+ end
39
+
40
+ private
41
+
42
+ def read_header
43
+ raise FormatError, "EMF+ snapshot is truncated" if @buffer.bytesize < HEADER_BYTES
44
+
45
+ magic, version, total, @segment_count, @frame_count, @diagnostic_count = @buffer.unpack("a4VQ<4")
46
+ raise FormatError, "not an EMF+ snapshot" unless magic == "EPSN"
47
+ raise FormatError, "unsupported EMF+ snapshot version #{version}" unless VERSIONS.include?(version)
48
+ raise FormatError, "EMF+ snapshot length mismatch" unless total == @buffer.bytesize
49
+
50
+ @cursor = HEADER_BYTES
51
+ end
52
+
53
+ def take(length)
54
+ raise FormatError, "EMF+ snapshot is truncated" if length.negative? || length > @buffer.bytesize - @cursor
55
+
56
+ @buffer.byteslice(@cursor, length).tap { @cursor += length }
57
+ end
58
+
59
+ def read_segments
60
+ Array.new(checked_count(@segment_count, SEGMENT_BYTES)) do
61
+ index, start, length, data_start = take(SEGMENT_BYTES).unpack("Q<4")
62
+ Segment.new(record_index: index, logical_start: start, payload_length: length, data_start: data_start)
63
+ end
64
+ end
65
+
66
+ def read_frames
67
+ Array.new(checked_count(@frame_count, FRAME_HEADER_BYTES)) do
68
+ head = take(FRAME_HEADER_BYTES)
69
+ index, offset, first, last, type, flags, size, data_size, tag, typed_length, raw_length = head.unpack("Q<4vvVVVQ<2")
70
+ raw = take(raw_length)
71
+ raise FormatError, "EMF+ snapshot frame size mismatch" unless raw_length == size
72
+
73
+ Frame.new(index: index, offset: offset, first_segment: first, last_segment: last, type: type, flags: flags,
74
+ frame_size: size, data_size: data_size, family: FAMILIES.fetch(tag) { raise FormatError, "unknown EMF+ family #{tag}" },
75
+ raw: raw, typed: take(typed_length))
76
+ end
77
+ end
78
+
79
+ def read_diagnostics
80
+ Array.new(checked_count(@diagnostic_count, DIAGNOSTIC_BYTES)) do
81
+ kind, role, frame, id, actual = take(DIAGNOSTIC_BYTES).unpack("VVQ<VV")
82
+ Diagnostic.new(kind: KINDS.fetch(kind) { raise FormatError, "unknown EMF+ diagnostic kind #{kind}" },
83
+ object_type: role, frame_index: frame, id: id, actual_type: actual)
84
+ end
85
+ end
86
+
87
+ # A count the remaining bytes cannot possibly hold is corrupt; this also
88
+ # bounds Array.new before any allocation.
89
+ def checked_count(count, minimum)
90
+ raise FormatError, "EMF+ snapshot count exceeds its length" if count > (@buffer.bytesize - @cursor) / minimum
91
+
92
+ count
93
+ end
94
+ end
95
+ end
96
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Emf
4
+ module Native
5
+ # Builds the Metafile#emf_plus_stream source for a native-backed metafile.
6
+ # The library is resolved at parse time; Native::EmfPlusStream loads lazily.
7
+ # A reload rebuilds from the current comment bytes, not the original input.
8
+ module EmfPlusSource
9
+ module_function
10
+
11
+ def call(input)
12
+ library = LibraryPath.new.call
13
+ lambda do |metafile, reload|
14
+ require_relative "emf_plus_stream"
15
+ EmfPlusStream.from_metafile(metafile, bytes: reload ? nil : input, library: library)
16
+ end
17
+ end
18
+ end
19
+ end
20
+ end
@@ -0,0 +1,150 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "digest"
4
+ require_relative "library_path"
5
+ require_relative "emf_plus_loader"
6
+ require_relative "emf_plus_snapshot"
7
+
8
+ module Emf
9
+ module Native
10
+ # An Emf::EmfPlus::Stream whose framing comes from the native EMF+ snapshot
11
+ # instead of the Ruby framer. The model is the Ruby one (Segment, typed
12
+ # Records, ObjectTable, editing, rebuild): each native frame's validated raw
13
+ # bytes are decoded by the same Records classes, so unedited output is
14
+ # byte-identical to the source. The native structured payloads are exposed
15
+ # beside it through #snapshot (frame family, normalized payload, and the
16
+ # object-reference diagnostics computed in Rust).
17
+ #
18
+ # Native framing follows the Ruby framer: each comment is framed on its own,
19
+ # a malformed header ends that comment's framing (the rest stays #unframed and
20
+ # the ParseError is collected), and an EMR_COMMENT whose cbData exceeds its
21
+ # record is clamped to the bytes it holds.
22
+ #
23
+ # .from_metafile returns nil whenever the native snapshot cannot stand in for
24
+ # the Ruby parse (library unavailable, a record whose typed layout the native
25
+ # decoder rejects where Ruby keeps an Unknown record, resource limits, or a
26
+ # segment layout that differs from Ruby's);
27
+ # the caller then uses Emf::EmfPlus::Stream.from_metafile, which keeps
28
+ # Ruby's error-collecting recovery. An edited stream (#with_record) keeps
29
+ # the Ruby model but carries no snapshot.
30
+ class EmfPlusStream < Emf::EmfPlus::Stream
31
+ SEGMENT = Emf::EmfPlus::Stream::Segment
32
+ LOADERS_LOCK = Mutex.new
33
+ private_constant :SEGMENT, :LOADERS_LOCK
34
+
35
+ attr_reader :snapshot
36
+
37
+ class << self
38
+ # `bytes` is the EMF file the metafile was parsed from; it is rebuilt from
39
+ # the metafile when omitted. `library` defaults to the configured native library.
40
+ def from_metafile(metafile, bytes: nil, library: LibraryPath.new.call)
41
+ return unless metafile.format == :emf_plus && library && !library.empty?
42
+
43
+ bytes ||= Emf::Emr::Serializer.call(metafile)
44
+ snapshot = EmfPlusSnapshot.new(loader(library).emf_plus_snapshot(bytes))
45
+ build(metafile, snapshot)
46
+ rescue Emf::Error
47
+ nil
48
+ end
49
+
50
+ private
51
+
52
+ def loader(library)
53
+ LOADERS_LOCK.synchronize { (@loaders ||= {})[library] ||= EmfPlusLoader.new(library) }
54
+ end
55
+
56
+ def build(metafile, snapshot)
57
+ comments = ruby_comment_segments(metafile)
58
+ return unless comments.map(&:first) == snapshot.segments.map(&:record_index)
59
+
60
+ errors = []
61
+ segments = comments.zip(snapshot.segments).map do |(index, payload_length), row|
62
+ segment(metafile, snapshot, index, row, payload_length, errors)
63
+ end
64
+ return if segments.any?(&:nil?)
65
+
66
+ new(source: metafile, segments: segments, errors: errors, digests: digests_of(metafile, segments), snapshot: snapshot)
67
+ end
68
+
69
+ # [comment record index, payload length] exactly as Segment.from_comment selects them.
70
+ def ruby_comment_segments(metafile)
71
+ metafile.records.each_with_index.filter_map do |record, index|
72
+ wire = record.wire
73
+ next unless wire.is_a?(Emf::Emr::Binary::Records::Comment) && wire.cb_data >= SEGMENT::IDENTIFIER.bytesize
74
+ next unless wire.data.b.start_with?(SEGMENT::IDENTIFIER)
75
+
76
+ [index, [wire.cb_data, wire.data.bytesize].min - SEGMENT::IDENTIFIER.bytesize]
77
+ end
78
+ end
79
+
80
+ def segment(metafile, snapshot, record_index, row, payload_length, errors)
81
+ return unless row.payload_length == payload_length && row.data_start == SEGMENT::IDENTIFIER.bytesize
82
+
83
+ data = metafile.records[record_index].wire.data.b
84
+ payload = data.byteslice(SEGMENT::IDENTIFIER.bytesize, payload_length)
85
+ frames = snapshot.frames.select { |frame| within?(frame, row) }
86
+ return unless frames.all? { |frame| spans_only?(frame, snapshot.segments, row) }
87
+
88
+ framed = frames.sum(&:frame_size)
89
+ return unless unframed_error(payload, framed, record_index, errors)
90
+
91
+ records = frames.map { |frame| decode(frame, row, record_index, errors) }
92
+ payload_end = SEGMENT::IDENTIFIER.bytesize + payload_length
93
+ SEGMENT.new(record_index: record_index, payload_range: SEGMENT::IDENTIFIER.bytesize...payload_end,
94
+ records: records, unframed: payload.byteslice(framed..), tail: data.byteslice(payload_end..))
95
+ end
96
+
97
+ # Native framing stops where the Ruby framer does; the unframed remainder
98
+ # must raise the same ParseError there (recorded in framing order, before
99
+ # record decode errors). A remainder Ruby would frame disagrees: no adoption.
100
+ def unframed_error(payload, framed, record_index, errors)
101
+ return true if framed == payload.bytesize
102
+
103
+ Emf::EmfPlus::Parser.read_frame(payload, framed, record_index)
104
+ false
105
+ rescue ParseError => e
106
+ errors << e
107
+ true
108
+ end
109
+
110
+ def within?(frame, row)
111
+ frame.offset >= row.logical_start && frame.offset < row.logical_start + row.payload_length
112
+ end
113
+
114
+ # A frame that crosses comments is malformed for Ruby (a record cannot span
115
+ # comments); only a frame wholly inside one segment is adopted.
116
+ def spans_only?(frame, segments, row)
117
+ segments[frame.first_segment].equal?(row) && frame.last_segment == frame.first_segment
118
+ end
119
+
120
+ def decode(frame, row, record_index, errors)
121
+ framed = Emf::EmfPlus::Frame.new(type: frame.type, flags: frame.flags, size: frame.frame_size, data_size: frame.data_size,
122
+ data: frame.raw.byteslice(Emf::EmfPlus::Frame::HEADER_BYTES..),
123
+ offset: frame.offset - row.logical_start, comment_index: record_index)
124
+ Emf::EmfPlus::Records.decode(framed)
125
+ rescue ParseError => e
126
+ errors << e
127
+ Emf::EmfPlus::Records::Unknown.new(framed)
128
+ end
129
+
130
+ def digests_of(metafile, segments)
131
+ segments.map { |segment| Digest::SHA256.digest(metafile.records[segment.record_index].to_binary_s) }
132
+ end
133
+ end
134
+
135
+ def initialize(snapshot: nil, **arguments)
136
+ super(**arguments)
137
+ @snapshot = snapshot
138
+ end
139
+
140
+ # The native family (EmfPlusSnapshot::FAMILIES) of the record at `handle`, or nil once edited.
141
+ def native_family(handle)
142
+ frame = snapshot&.frames&.at(handle.stream_index)
143
+ frame&.family
144
+ end
145
+
146
+ # Object-reference problems Rust found, resolved against the same table order as #resolve.
147
+ def reference_diagnostics = snapshot ? snapshot.diagnostics : []
148
+ end
149
+ end
150
+ end