Add `event_mask` to `Sample.get_events`

[whitews]

Add event_mask to Sample.get_events to allow filtering events (e.g. for use with Boolean gate membership arrays).