Emboss & Wrap
Both operations put a 2D profile onto a curved face, then add material
there (mode=EmbossMode.RAISE, the default) or cut it in
(EmbossMode.ENGRAVE) by depth. Pick the face with a FaceFinder.
Emboss(solid, profile, face, depth) projects the profile straight
along its sketch normal, like a shadow. Draw it on any plane facing the face:
the star (blue bar) is drawn on a plane above the bar and raised 1 mm onto its
round top. The slot (green bar) is engraved 0.8 mm the same way. A projection
stretches the profile where the face slopes away from the sketch.
Wrap(solid, profile, face, depth) rolls the profile around a
cylindrical face instead, so lengths are kept. The sketch’s x axis runs around
the cylinder (x = arc length) and its y axis along it. Draw the profile on a
plane tangent to the cylinder, with the sketch origin on the surface, e.g.
self.xz().get_parallel_plane(radius) for the front of an upright can.
On the orange can, a 50 × 12 label recess is wrapped 0.6 mm deep, and its
50 mm really runs 50 mm around the circumference. Then Text is wrapped onto
the recess floor and raised 0.6 mm, so the lettering ends flush with the can.
Keep a wrapped profile within one face: an extruded circle’s side is two half-cylinder faces, so a label can span up to half the circumference.